@ai-sdlc/orchestrator 0.10.0 → 0.14.0

package/dist/cli/commands/init-templates.js

@@ -44,8 +44,12 @@ export const AI_SDLC_GATE_WORKFLOW = `name: AI-SDLC PR Ready Gate
 # pytest, pip-tools, Open edX, PyCA, PyPA, Mergify.
 
 on:
+  # AISDLC-261 PR #480 review fix: include 'ready_for_review' so the gate
+  # fires when adopters using the draft-PR flow (AISDLC-218) flip a PR
+  # from draft to ready. Without it, ai-sdlc/pr-ready stays unposted on
+  # the ready transition and branch protection fails.
   pull_request:
-    types: [opened, synchronize, reopened]
+    types: [opened, synchronize, reopened, ready_for_review]
   merge_group:
     types: [checks_requested]
 
@@ -364,6 +368,481 @@ spec:
     testOnly: cheap
     default: mid
 `;
+/**
+ * `.github/workflows/ai-sdlc-review.yml` — CI-side PR review workflow.
+ *
+ * Posts `Post Review Results` as a commit status so branch-protection can
+ * require it. Adopter repos that have not set up `ANTHROPIC_API_KEY` will
+ * see the job run but produce advisory-only output — the status check still
+ * posts `success` so it does not block merges.
+ *
+ * This is a simplified adopter-facing template. The AI-SDLC framework's
+ * own repo carries a more elaborate version that drives the full review
+ * fan-out pipeline (classifier, incremental review, etc.); adopters start
+ * here and can progressively opt into those features.
+ *
+ * Source of truth: `.github/workflows/ai-sdlc-review.yml` in the ai-sdlc
+ * framework repo (AISDLC-261). Mirror changes here when the adopter-facing
+ * surface evolves.
+ */
+export const AI_SDLC_REVIEW_WORKFLOW = `name: AI-SDLC PR Review
+
+# Posts \`Post Review Results\` as a required commit status.
+# Docs-only PRs (spec/rfcs/**, docs/**, backlog/**, *.md) are short-circuited
+# with success so they do not block the merge queue.
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+    branches: [main]
+    paths-ignore:
+      - 'spec/rfcs/**'
+      - 'docs/**'
+      - 'backlog/tasks/**'
+      - 'backlog/completed/**'
+      - '*.md'
+  merge_group:
+    types: [checks_requested]
+
+concurrency:
+  group: review-\${{ github.event.pull_request.number || github.event.merge_group.head_sha }}
+  cancel-in-progress: true
+
+jobs:
+  docs-only-check:
+    name: Docs-only check
+    runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    permissions:
+      contents: read
+      statuses: write
+      pull-requests: read
+    steps:
+      - name: Resolve event SHA
+        id: resolve
+        run: |
+          if [ "\${{ github.event_name }}" = "merge_group" ]; then
+            echo "head_sha=\${{ github.event.merge_group.head_sha }}" >> "\${GITHUB_OUTPUT}"
+            echo "base_sha=\${{ github.event.merge_group.base_sha }}" >> "\${GITHUB_OUTPUT}"
+            echo "is_merge_group=true" >> "\${GITHUB_OUTPUT}"
+          else
+            echo "head_sha=\${{ github.event.pull_request.head.sha }}" >> "\${GITHUB_OUTPUT}"
+            echo "is_merge_group=false" >> "\${GITHUB_OUTPUT}"
+          fi
+
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: \${{ steps.resolve.outputs.head_sha }}
+
+      - name: Detect docs-only changeset
+        id: detect
+        env:
+          GH_TOKEN: \${{ github.token }}
+          PR_NUMBER: \${{ github.event.pull_request.number }}
+          REPO: \${{ github.repository }}
+          IS_MERGE_GROUP: \${{ steps.resolve.outputs.is_merge_group }}
+          BASE_SHA: \${{ steps.resolve.outputs.base_sha }}
+          HEAD_SHA: \${{ steps.resolve.outputs.head_sha }}
+        run: |
+          set -euo pipefail
+          if [ "\${IS_MERGE_GROUP}" = "true" ]; then
+            FILES=$(git -c core.quotePath=false diff --name-only "\${BASE_SHA}...\${HEAD_SHA}")
+          else
+            FILES=$(gh api "repos/\${REPO}/pulls/\${PR_NUMBER}/files" --paginate --jq '.[].filename')
+          fi
+          if [ -z "\${FILES}" ]; then
+            echo "all_docs=true" >> "\${GITHUB_OUTPUT}"
+            exit 0
+          fi
+          # Simple docs-only check: all files must be in docs, spec/rfcs, backlog, or *.md
+          ALL_DOCS=true
+          while IFS= read -r f; do
+            case "$f" in
+              docs/*|spec/rfcs/*|backlog/tasks/*|backlog/completed/*|*.md) ;;
+              *) ALL_DOCS=false; break ;;
+            esac
+          done <<< "\${FILES}"
+          echo "all_docs=\${ALL_DOCS}" >> "\${GITHUB_OUTPUT}"
+
+      - name: Post Review Results (docs-only short-circuit)
+        if: steps.detect.outputs.all_docs == 'true'
+        env:
+          GH_TOKEN: \${{ github.token }}
+          REPO: \${{ github.repository }}
+          HEAD_SHA: \${{ steps.resolve.outputs.head_sha }}
+        run: |
+          set -euo pipefail
+          gh api "repos/\${REPO}/statuses/\${HEAD_SHA}" \\
+            -X POST \\
+            -f state=success \\
+            -f context='Post Review Results' \\
+            -f description='docs-only changeset — review N/A'
+          echo "Posted Post Review Results: success (docs-only) on \${HEAD_SHA}"
+
+  review:
+    name: Post Review Results
+    runs-on: ubuntu-latest
+    if: >-
+      github.event_name == 'pull_request' &&
+      !startsWith(github.head_ref, 'release-please--') &&
+      github.event.pull_request.draft == false
+    needs: [docs-only-check]
+    permissions:
+      contents: read
+      pull-requests: write
+      statuses: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Post Review Results (stub — fails closed by default)
+        env:
+          GH_TOKEN: \${{ github.token }}
+          REPO: \${{ github.repository }}
+          HEAD_SHA: \${{ github.event.pull_request.head.sha }}
+          # AISDLC-261 PR #480 review fix (CRITICAL): the stub now defaults to
+          # FAILURE so adopters who configure 'Post Review Results' as a required
+          # branch-protection check + enable auto-merge don't accidentally ship
+          # a phantom review gate that auto-merges every PR with zero review.
+          # To opt in to auto-pass while wiring your reviewers, set the repo
+          # variable AISDLC_REVIEW_STUB_AUTOPASS=true. Real reviewer wiring
+          # should replace this entire step.
+          AUTOPASS: \${{ vars.AISDLC_REVIEW_STUB_AUTOPASS }}
+        run: |
+          set -euo pipefail
+          if [ "\${AUTOPASS:-}" = "true" ]; then
+            STATE=success
+            DESC='Review passed (STUB AUTOPASS — wire your reviewers, then unset AISDLC_REVIEW_STUB_AUTOPASS)'
+          else
+            STATE=failure
+            DESC='Review stub not wired. Either replace this workflow step with your reviewers OR set repo var AISDLC_REVIEW_STUB_AUTOPASS=true (acknowledged risk).'
+          fi
+          gh api "repos/\${REPO}/statuses/\${HEAD_SHA}" \\
+            -X POST \\
+            -f state="\${STATE}" \\
+            -f context='Post Review Results' \\
+            -f description="\${DESC}"
+          echo "Posted Post Review Results: \${STATE} on \${HEAD_SHA}"
+`;
+/**
+ * `.github/workflows/auto-enable-auto-merge.yml` — auto-arms GitHub auto-merge
+ * on every new same-repo PR so the PR merges automatically as soon as required
+ * checks pass. Release-please PRs are excluded (operator arms manually).
+ *
+ * Source of truth: `.github/workflows/auto-enable-auto-merge.yml` in the
+ * ai-sdlc framework repo (AISDLC-261). Mirror changes here when the
+ * auto-merge strategy or exclude rules evolve.
+ *
+ * Requires:
+ *   - GitHub repo setting "Allow auto-merge" must be enabled.
+ *   - \`AI_SDLC_PAT\` secret with write access to the repo (or use
+ *     \`secrets.GITHUB_TOKEN\` if the repo's default token has write access).
+ */
+export const AUTO_ENABLE_AUTO_MERGE_WORKFLOW = `name: Auto-enable auto-merge on PR open
+
+# Enables GitHub's auto-merge on every new same-repo PR. Once required
+# checks pass, GitHub adds the PR to the merge queue which rebases + runs
+# CI + merges if green. No human click needed.
+#
+# Requires repo setting "Allow auto-merge" to be enabled (Settings → General).
+# Requires a PAT or GitHub App token with \`pull_requests: write\` stored as
+# the \`AI_SDLC_PAT\` repository secret (or swap for \`github.token\` if your
+# repo grants it write access).
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  check_suite:
+    types: [completed]
+  status:
+
+permissions:
+  pull-requests: write
+  contents: write
+
+jobs:
+  enable-auto-merge:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Discover PR for this event
+        id: discover
+        env:
+          GH_TOKEN: \${{ secrets.AI_SDLC_PAT }}
+          GH_REPO: \${{ github.repository }}
+          EVENT_NAME: \${{ github.event_name }}
+          PR_NUMBER_FROM_PR_EVENT: \${{ github.event.pull_request.number }}
+          HEAD_SHA: \${{ github.event.check_suite.head_sha || github.event.sha || github.sha }}
+        run: |
+          set -euo pipefail
+          if [ "$EVENT_NAME" = "pull_request" ]; then
+            echo "pr=$PR_NUMBER_FROM_PR_EVENT" >> "$GITHUB_OUTPUT"
+          else
+            PR=$(gh api "/repos/$GH_REPO/commits/$HEAD_SHA/pulls" --jq '.[] | select(.state == "open") | .number' | head -1)
+            echo "pr=\${PR:-}" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Skip when no PR matches
+        if: steps.discover.outputs.pr == ''
+        run: echo "[auto-enable] no open PR for this event — nothing to arm."
+
+      - name: Skip drafts, fork PRs, and release-please PRs
+        id: guard
+        if: steps.discover.outputs.pr != ''
+        env:
+          GH_TOKEN: \${{ secrets.AI_SDLC_PAT }}
+          GH_REPO: \${{ github.repository }}
+          PR: \${{ steps.discover.outputs.pr }}
+          REPO: \${{ github.repository }}
+        run: |
+          set -euo pipefail
+          PR_INFO=$(gh pr view "$PR" --json isDraft,headRepositoryOwner,headRepository,headRefName \\
+            -q '{isDraft: .isDraft, headRefName: .headRefName, headFull: (((.headRepositoryOwner.login // "") + "/" + (.headRepository.name // "")) // "")}')
+          IS_DRAFT=$(echo "$PR_INFO" | jq -r '.isDraft')
+          HEAD_FULL=$(echo "$PR_INFO" | jq -r '.headFull')
+          HEAD_REF=$(echo "$PR_INFO" | jq -r '.headRefName')
+          if [ "$IS_DRAFT" = "true" ]; then
+            echo "[auto-enable] PR #$PR is draft — skipping."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          elif [ "$HEAD_FULL" = "/" ] || [ -z "$HEAD_FULL" ]; then
+            # AISDLC-261 PR #480 review fix: defensive — head repository was
+            # deleted or API returned an empty shape. Refuse to arm; operator
+            # can re-arm manually if intended.
+            echo "[auto-enable] PR #$PR has no resolvable head repository — skipping."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          elif [ "$HEAD_FULL" != "$REPO" ]; then
+            echo "[auto-enable] PR #$PR is from a fork ($HEAD_FULL) — skipping."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          elif case "$HEAD_REF" in release-please--*) true ;; *) false ;; esac; then
+            echo "[auto-enable] PR #$PR is a release-please PR — skipping. Arm manually when ready."
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "skip=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Refresh auto-merge
+        if: steps.discover.outputs.pr != '' && steps.guard.outputs.skip != 'true'
+        env:
+          GH_TOKEN: \${{ secrets.AI_SDLC_PAT }}
+          PR: \${{ steps.discover.outputs.pr }}
+        run: |
+          # disable-then-arm to clear any stale GitHub auto-merge state.
+          gh pr merge --disable-auto "$PR" 2>/dev/null || true
+          gh pr merge --auto "$PR"
+`;
+/**
+ * `.ai-sdlc/calibration.yaml` — per-org calibration config for the
+ * RFC-0031 DIDRevisionProposal mechanism (Refit AISDLC-310).
+ *
+ * Exposes OQ-12.1 (confidence thresholds) and OQ-12.5 (rejection weights +
+ * penalty floor) as per-org configurable defaults. All values default to
+ * the operator-affirmed shipped defaults from AISDLC-271 / PR #476.
+ *
+ * Drift policy: when `parseRevisionProposalCalibrationYaml()` in
+ * `orchestrator/src/sa-scoring/revision-proposal-config.ts` gains new
+ * config fields, mirror them here. The values in this template MUST match
+ * the DEFAULT_* constants exported from that module.
+ */
+export const CALIBRATION_YAML_STUB = `# RFC-0031 DIDRevisionProposal calibration config (Refit AISDLC-310).
+#
+# Configures per-org thresholds and weights for the calibration-driven
+# DID revision proposal mechanism. All values below are the shipped
+# defaults (operator-affirmed 2026-05-16 audit). Adjust to tune the
+# mechanism for your SOUL-drift cadence and review culture.
+#
+# Validation rules (enforced at load time by the runtime):
+#   - confidenceThresholds.highSampleSize > lowSampleSize > 0
+#   - all rejectionPrecedent.weights in [0, 1]
+#   - rejectionPrecedent.confidencePenaltyFloor in [0, 1]
+
+calibration:
+  # Fields that should never receive auto-proposals (OQ-12.3).
+  # Add JSON-path identifiers for fields the triad has decided to lock.
+  # Operators remove entries from this list to opt back in.
+  lockNoProposal: []
+    # - $.identityClass.evolving.voiceRegister
+    # - $.identityClass.core.soulPurpose.mission
+
+  # Confidence threshold configuration (OQ-12.1).
+  # Sample size = dismissSignals + escalateSignals + driftEvents.
+  confidenceThresholds:
+    highSampleSize: 20     # sample size >= this → HIGH confidence (if other conditions met)
+    lowSampleSize: 5       # sample size <  this → LOW confidence (regardless of other conditions)
+
+  # Rejection precedent configuration (OQ-12.5).
+  # When a proposal is rejected, a weight is stored in the rejection record
+  # and averaged across prior rejections to suppress future confidence for
+  # the same field.  Formula: factor = max(floor, 1.0 - avgWeight x 0.5)
+  rejectionPrecedent:
+    weights:
+      highConfidenceRejection: 0.8   # strong disagreement signal
+      mediumConfidenceRejection: 0.5 # moderate disagreement
+      lowConfidenceRejection: 0.2    # expected noise level; low weight
+    confidencePenaltyFloor: 0.2      # max 80% suppression; raise to be more conservative
+`;
+/**
+ * `.ai-sdlc/embedding-config.yaml` — per-org embedding-framework defaults
+ * per RFC-0019 §15.1 (operator re-walkthrough 2026-05-21). Includes every
+ * NEW field surfaced by the re-walkthrough (marked as such inline):
+ *   - scaleEscalationHeuristic (OQ-1)
+ *   - perConsumerOverridesAllowed (OQ-2)
+ *   - crossProviderPolicy split (OQ-3)
+ *   - catalogDedup milestones (OQ-4)
+ *   - unifiedCostReport (OQ-6 + OQ-7)
+ *   - adapterBillingModelRespected (OQ-7)
+ *
+ * The framework reads this file when `AI_SDLC_EMBEDDING_PROVIDER=on` AND
+ * `Pipeline.spec.embedding` is present. Per-pipeline fields in
+ * `Pipeline.spec.embedding` override the corresponding per-org defaults here.
+ *
+ * The file is OPTIONAL — when absent, framework defaults apply (matching
+ * the values below). Operators commit this file to make the defaults
+ * explicit + reviewable.
+ */
+export const EMBEDDING_CONFIG_YAML_STUB = `# Per-org embedding-framework defaults (RFC-0019 §15.1).
+#
+# Read by the framework when AI_SDLC_EMBEDDING_PROVIDER=on. Per-pipeline
+# fields under spec.embedding override these defaults. The file is
+# OPTIONAL — when absent, the framework defaults below apply.
+#
+# Reference: spec/rfcs/RFC-0019-embedding-provider-adapter.md §15.1
+# Runbook:   docs/operations/embedding-providers.md
+
+embedding:
+  provider: openai-text-embedding-3-small   # default adapter (OQ-5 + Phase 1)
+
+  storage:                              # OQ-1 — JSONL backend + scale-escalation heuristic
+    backend: jsonl
+    path: \${ARTIFACTS_DIR}/_embeddings/
+    gcRetentionDays: 90                 # mtime-based GC threshold
+    scaleEscalationHeuristic:           # NEW (re-walkthrough): operator-visible swap trigger
+      maxEntriesPerProvider: 100000     # > 100K → swap to sqlite or vector DB
+      maxP95ReadLatencyMs: 250          # OR > 250ms p95 read → swap
+      operatorRunbook: docs/operations/embedding-providers.md#scale-escalation
+
+  staleVectorPolicy:                    # OQ-2 — per-org default + per-consumer override
+    default: lazy-re-embed              # alternatives: fail-loud | warn
+    logToCatalog: true                  # log every stale-vector event as Decision
+    perConsumerOverridesAllowed: true   # NEW (re-walkthrough): consumers may pin policy at API
+                                        # site (e.g., RFC-0009 Eτ drift pins fail-loud regardless
+                                        # of org default to preserve historical-trajectory fidelity)
+
+  crossProviderPolicy:                  # OQ-3 — split (re-walkthrough refinement)
+    crossProvider: refuse               # ALWAYS strict no-op cross-PROVIDER (openai vs cohere)
+                                        # → Decision: cross-provider-comparison-attempted
+    crossVersionWithinProvider: delegate-to-staleVectorPolicy
+                                        # cross-VERSION delegates to OQ-2 (resolves v0.2 conflict)
+
+  deprecation:                          # OQ-4 — three-layer precedence + catalog dedup
+    gracePeriodDays: 90                 # framework default; adapter may declare defaultGracePeriodDays
+    strictModeAtDeprecatedAt: false
+    catalogDedup:                       # NEW (re-walkthrough): prevent Decision flood under orchestrator
+      enabled: true
+      milestonesDaysBeforeDeprecatedAt: [89, 60, 30, 7, 1]
+                                        # emit Decisions at milestones, NOT per-load
+
+  costTracking:                         # OQ-6 — distinct line item + per-consumer attribution
+    lineItem: embeddingTokens
+    budgetIntegration: rfc-0004
+    consumerLabelRequired: false        # NEW (re-walkthrough): optional but recommended;
+                                        # callers pass consumerLabel for per-category attribution
+                                        # (e.g., 'rfc-0009-tessellation-drift', 'rfc-0008-ppa-similarity')
+    unifiedCostReport:                  # NEW (re-walkthrough): cross-substrate finance view
+      enabled: true                     # aggregates embeddingTokens + inputTokens + outputTokens +
+                                        # SubscriptionLedger window cost; tagged by costModel
+      costModelLabels:
+        - subscription-quota            # Claude Code Max / Codex
+        - pay-per-token                 # OpenAI / Cohere / future Anthropic embeddings if launched
+
+  subscriptionLedgerInteraction:        # OQ-7 — separation + per-adapter billingModel
+    consumeQuotaDefault: false          # default for pay-per-token adapters
+    adapterBillingModelRespected: true  # NEW (re-walkthrough): adapter declares
+                                        # 'pay-per-token' | 'subscription-quota' in capability matrix;
+                                        # subscription-quota adapters route through SubscriptionLedger
+                                        # (e.g., future Anthropic embeddings if shipped)
+`;
+/**
+ * Per-soul DesignSystemBinding template (RFC-0009 Phase 2.2).
+ *
+ * Scaffolded at `.ai-sdlc/souls/<slug>/design-system-binding.yaml` for
+ * each soul in a Tessellated Platform. The `spec.extends` field records
+ * the parent platform-root DSB name, implementing the additive inheritance
+ * chain described in RFC-0009 §6.
+ *
+ * Drift policy: when `DesignSystemBindingSpec` gains new required fields,
+ * mirror them here so that freshly-scaffolded soul DSBs are immediately valid.
+ *
+ * @param soulSlug - the soul identifier (e.g. "soul-a"); used in resource name
+ * @param platformDsbName - the parent platform-root DSB name (defaults to
+ *   the literal placeholder `platform-dsb` for adopters to replace)
+ */
+export function buildSoulDsbTemplate(soulSlug, platformDsbName = 'platform-dsb') {
+    return `apiVersion: ai-sdlc.io/v1alpha1
+kind: DesignSystemBinding
+metadata:
+  name: ${soulSlug}-dsb
+  labels:
+    ai-sdlc/soul: "${soulSlug}"
+    ai-sdlc/scope: soul
+spec:
+  # Additively extends the platform-root DSB (RFC-0009 §6 resolution rules).
+  # Per-soul fields override / extend platform-root fields; absent fields
+  # fall through to the platform-root DSB at admission time.
+  extends: ${platformDsbName}
+
+  stewardship:
+    designAuthority:
+      # Soul-specific design authority — added to the platform-root authority set.
+      # Replace with your actual design authority contact(s).
+      principals:
+        - your-design-authority@example.com
+      scope:
+        - ${soulSlug}-design-intent
+    engineeringAuthority:
+      # Replace with your actual engineering authority contact(s).
+      principals:
+        - your-engineering-authority@example.com
+      scope:
+        - ${soulSlug}-compliance
+
+  designToolAuthority: specification
+
+  tokens:
+    provider: tokens-studio
+    format: w3c-dtcg
+    source:
+      repository: your-org/design-tokens
+      # Soul-specific token branch — override the platform-root source when
+      # this soul maintains divergent token values.
+      branch: soul/${soulSlug}
+      path: tokens/souls/${soulSlug}/
+    versionPolicy: minor
+
+  catalog:
+    provider: storybook
+    source:
+      # Soul-specific Storybook URL — override platform URL when souls have
+      # separate component catalogs.
+      storybookUrl: https://${soulSlug}.storybook.your-org.io
+
+  compliance:
+    coverage:
+      # Soul-specific coverage threshold (integer percent 0-100) — may be
+      # stricter than platform floor.
+      minimum: 70
+      target: 90
+
+  designReview:
+    required: true
+    # Soul-specific reviewers — unioned with platform-root reviewers at
+    # admission time per §6.3 additive resolution.
+    reviewers: []
+    scope:
+      - visual-quality
+      - accessibility-intent
+`;
+}
 export const DOR_TEMPLATES = {
     files: {
         '.ai-sdlc/dor-config.yaml': DOR_CONFIG_STUB,
@@ -385,15 +864,478 @@ export const CLASSIFIER_TEMPLATES = {
         '.ai-sdlc/review-classifier.yaml': REVIEW_CLASSIFIER_STUB,
     },
 };
+/**
+ * `.ai-sdlc/quality-monitoring.yaml` stub — RFC-0025 §13.1 per-org config.
+ *
+ * AISDLC-305 / Phase 4: ships the documented §13.1 defaults across all
+ * resolved OQ surfaces:
+ *   - OQ-1 confidence-bucketed classifier thresholds
+ *   - OQ-2 per-axis severity weights
+ *   - OQ-3 multi-window recurrence
+ *   - OQ-4 framework-bug suggest-only attribution
+ *   - OQ-5 upstream reporting (operator-initiated)
+ *   - OQ-6 coverage-gap response
+ *   - OQ-7 composite determinism sampling
+ *   - OQ-9 operator-time-cost instrumentation
+ *   - OQ-10 vendor-namespace enforcement (strict by default)
+ *
+ * All values are commented-out so the file is documentation-as-data: the
+ * defaults inside `pipeline-cli/src/tui/analytics/quality-monitoring-config.ts`
+ * remain the source of truth, but operators get a complete cribsheet of
+ * what they can tune by un-commenting and editing.
+ */
+export const QUALITY_MONITORING_CONFIG_STUB = `# RFC-0025 Framework Quality Monitoring configuration (§13.1).
+#
+# Per-org overrides for the AI-SDLC framework's failure-mode taxonomy,
+# severity rubric, attribution UX, and self-improvement metrics. Every
+# block below ships with sensible small-to-medium-team defaults
+# (un-commented entries override the defaults).
+#
+# Lifecycle:
+#   - Drop this file in \`.ai-sdlc/\` to override defaults org-wide.
+#   - Pass \`--severity-weight <axis>=<value>\` on relevant CLIs for a
+#     one-shot debugging override (precedence: CLI > YAML > defaults).
+#   - The loader rejects un-namespaced custom subclasses by default
+#     (OQ-10 strict enforcement); set \`vendor-namespace.enforce: warn\`
+#     to downgrade to a soft warning during migration (deprecated).
+#
+# See RFC-0025 §13.1 for the full schema rationale + OQ resolutions.
+
+quality:
+  # OQ-1 / Phase 2 — Confidence-bucketed classifier (three-tier).
+  # classifier:
+  #   confidenceThresholds:
+  #     autoClassify: 0.7   # ≥ this → auto-classify into the resolved class
+  #     ambiguous: 0.3      # ≥ this and < autoClassify → ambiguous;
+  #                         # < this → unclassified, log-only
+
+  # OQ-2 / Phase 4 — Per-axis severity weights for the §7 composite rubric.
+  # Multiplies the qualitative axis (low=0, medium=1, high=2) before the
+  # max + frequency bump. A weight of 1.0 is the qualitative-bucket default.
+  # severity-weights:
+  #   operator-time-cost: 1.0
+  #   framework-recurrence: 1.0
+  #   blast-radius: 1.0
+
+  # OQ-3 / Phase 3 — Multi-window recurrence (simultaneously computed).
+  # recurrence-windows:
+  #   - 7d   # flap detection
+  #   - 30d  # standard recurrence
+  #   - 90d  # legacy regression
+
+  # OQ-4 / Phase 4 — Framework-bug attribution UX. Default is suggest-only
+  # (small-team-safe per the operator-affirmed OQ-4 resolution). Flip
+  # \`autoAttribute: true\` to force-assign the top candidates on creation.
+  # framework-bug:
+  #   autoAttribute: false
+  #   suggestionCount: 3
+  #   attributionSources:
+  #     - codeowners
+  #     # - git-blame   # v2 extension (RFC-0025 §13.1)
+  #     # - recent-pr   # v2 extension
+
+  # OQ-5 / Phase 6 — Operator-initiated upstream reporting. Set
+  # \`repoUrl\` to your framework-repo to enable \`cli-quality report-upstream\`.
+  # upstream-reporting:
+  #   repoUrl: "https://github.com/<org>/<repo>"
+  #   prefilledIssueTemplate: ".ai-sdlc/templates/framework-bug-report.md"
+
+  # OQ-6 / Phase 5 — Coverage-gap response. Composes with RFC-0024
+  # emergent capture (capture-record with source: framework-coverage-gap).
+  # coverage-gap:
+  #   autoQuarantine: true
+  #   fileCapture: true
+
+  # OQ-7 / Phase 5 — Composite determinism-detection sampling. Risk-based
+  # concentration via blast-radius matches the framework's deterministic-
+  # first preflight ladder (RFC-0035 §5).
+  # determinism-detection:
+  #   defaultSampleRate: 0.02            # 1-in-50 baseline
+  #   alwaysOnRequiresDeterminism: true
+  #   alwaysOnTopBlastRadiusDecile: true
+
+  # OQ-9 / Phase 5 — Operator-time-cost instrumentation. AFK filter zeroes
+  # out elapsed-time over inactivity gaps > N minutes (default 30).
+  # operator-time-cost:
+  #   afkInactivityMinutes: 30
+
+  # OQ-10 / Phase 6 — Vendor-namespace enforcement for custom failure-mode
+  # subclasses. Matches Kubernetes CRD / npm scoped / Go module convention.
+  # vendor-namespace:
+  #   enforce: reject    # or 'warn' (deprecated) / 'none' (deprecated)
+
+  # OQ-10 / Phase 6 — Adopter-declared custom failure-mode subclasses.
+  # Each entry MUST use a vendor reverse-DNS prefix under the default
+  # \`enforce: reject\`. Un-prefixed entries error at resource-load time.
+  # customSubclasses:
+  #   - acme-corp:custom-gate-faulty
+  #   - acme-corp:billing-timeout
+`;
+/**
+ * `.ai-sdlc/templates/framework-bug-report.md` stub — adopter-customisable
+ * template for the OQ-5 upstream-reporting CLI (\`cli-quality report-upstream\`).
+ *
+ * The template uses double-brace placeholders that the
+ * \`tui/analytics/upstream-reporter.ts\` module replaces at render time:
+ *   {{subclass}}, {{severity_composite}}, {{severity_otc}},
+ *   {{severity_blast}}, {{severity_freq}}, {{ts}}, {{task_id}},
+ *   {{worker_id}}, {{rationale}}, {{suggested_fix}}, {{related_paths}},
+ *   {{exit_code}}, {{source}}, {{stderr_tail}}
+ *
+ * Adopters can re-order sections + add markdown but should keep the
+ * placeholder names — the renderer's substitution table is fixed.
+ */
+export const FRAMEWORK_BUG_REPORT_TEMPLATE_STUB = `## Framework bug — {{subclass}}
+
+**Severity:** {{severity_composite}} (operator-time-cost={{severity_otc}}, blast-radius={{severity_blast}}, frequency={{severity_freq}})
+**Subclass:** \`{{subclass}}\`
+**Reported at (capture timestamp):** {{ts}}
+**Related task:** {{task_id}}
+**Worker:** {{worker_id}}
+
+### What happened
+
+The AI-SDLC framework's RFC-0025 quality monitor classified this failure as
+\`framework-misbehaved\` / \`{{subclass}}\`. Per the classifier's rationale:
+
+> {{rationale}}
+
+### Suggested fix (heuristic — please verify)
+
+{{suggested_fix}}
+
+### Related code paths
+
+{{related_paths}}
+
+### Anonymised repro
+
+The framework anonymised the failure context before this template
+rendered: absolute home paths were collapsed to \`~/…\`, worktree paths to
+\`<worktree>\`, and any apparent secret tokens (sk-…, ghp_…, xoxb-…) or
+email addresses were replaced with \`<REDACTED-…>\`. The operator should
+still inspect the body before submitting.
+
+\`\`\`
+exit code: {{exit_code}}
+source:    {{source}}
+
+{{stderr_tail}}
+\`\`\`
+
+### Operator checklist (before clicking Submit)
+
+- [ ] I have reviewed the anonymised repro for any remaining sensitive context.
+- [ ] The classifier's rationale matches what I observed locally.
+- [ ] The suggested fix and related paths look correct for this failure.
+- [ ] I am willing to follow up on the issue if the maintainers ask for more context.
+
+---
+
+_This issue was pre-generated by \`cli-quality report-upstream\` (RFC-0025 §13 OQ-5)._
+_The operator reviewed and submitted this report. No automatic telemetry was transmitted._
+`;
+/**
+ * Quality-monitoring template set scaffolded by the wizard's
+ * \`--with-quality-monitoring\` / \`--add quality-monitoring\` flag
+ * (AISDLC-305). Bundles the OQ-2 + OQ-4 + OQ-5 surfaces:
+ *
+ *   1. \`.ai-sdlc/quality-monitoring.yaml\` — RFC-0025 §13.1 per-org config
+ *      with all blocks commented-out (shipping defaults documented inline).
+ *   2. \`.ai-sdlc/templates/framework-bug-report.md\` — adopter-customisable
+ *      template for the OQ-5 upstream-reporting CLI.
+ *
+ * Idempotent: files already present at the target paths are skipped by the
+ * dispatcher.
+ */
+export const QUALITY_MONITORING_TEMPLATES = {
+    files: {
+        '.ai-sdlc/quality-monitoring.yaml': QUALITY_MONITORING_CONFIG_STUB,
+        '.ai-sdlc/templates/framework-bug-report.md': FRAMEWORK_BUG_REPORT_TEMPLATE_STUB,
+    },
+};
+/**
+ * `.ai-sdlc/signal-ingestion.yaml` stub — RFC-0030 Signal Ingestion Pipeline.
+ *
+ * AISDLC-348 / Phase 6: ships the full §11 config schema with every block
+ * commented-out under `enabled: false`. The pipeline is OFF until the
+ * operator explicitly flips `enabled: true` AND opts in via the
+ * `AI_SDLC_SIGNAL_INGESTION` flag during the soak window.
+ *
+ * Like `QUALITY_MONITORING_CONFIG_STUB`, this file is documentation-as-data:
+ * the runtime defaults inside `orchestrator/src/signal-ingestion/config.ts`
+ * (DEFAULT_SIGNAL_INGESTION_CONFIG) are the source of truth, but operators
+ * get a complete cribsheet of what they can tune. Tier multipliers, ICP
+ * resonance weights, SA-resonance thresholds, Tier-2 significance gate,
+ * clustering algorithm, D1 composition split, and adapter list are all
+ * documented inline with the shipped defaults.
+ *
+ * Drift policy: when DEFAULT_SIGNAL_INGESTION_CONFIG gains new fields,
+ * mirror them here so freshly-scaffolded configs are immediately complete.
+ * The values in the commented blocks below MUST match the constants in
+ * `config.ts`.
+ *
+ * Configuration changes to this file emit `SignalIngestionConfigChanged`
+ * events to `events.jsonl` (see RFC-0030 §11 closing note + AISDLC-348
+ * governance event logger). Operators should treat tier-multiplier edits,
+ * threshold tweaks, and adapter list changes as governance-relevant: they
+ * change which customer signals the framework treats as load-bearing
+ * demand and therefore affect D1 scoring upstream of the dispatcher.
+ */
+export const SIGNAL_INGESTION_CONFIG_STUB = `# RFC-0030 Signal Ingestion Pipeline configuration (§11).
+#
+# Per-org config for the Demand Sources → D1 pipeline. Pluggable source
+# adapters fetch raw signals (support tickets, community threads, manual
+# entries), classify them by tier + ICP + recency, cluster them into
+# demand themes, filter through SA resonance, and feed D1 cluster-level
+# demand scores into PPA.
+#
+# Ships DISABLED by default. The pipeline is gated by both:
+#   1. \`spec.enabled: true\` in this file
+#   2. \`AI_SDLC_SIGNAL_INGESTION\` env flag set to a truthy value during
+#      the soak window (1/true/yes/on). Post-promotion the flag is default-on
+#      and only the YAML toggle matters.
+#
+# Configuration changes emit \`SignalIngestionConfigChanged\` governance
+# events to \`<ARTIFACTS_DIR>/_orchestrator/events-YYYY-MM-DD.jsonl\`. Edits
+# to tier multipliers, thresholds, or adapter lists are governance-relevant
+# (RFC-0030 §11 closing note) — log + product-lead review them like any
+# other DID-adjacent decision.
+#
+# Operator runbook: docs/operations/signal-ingestion.md
+# Promotion runbook: docs/operations/signal-ingestion-promotion.md
+# Schema: spec/schemas/signal-ingestion-config.v1.schema.json
+# RFC: spec/rfcs/RFC-0030-signal-ingestion-pipeline.md
+# Re-walkthrough (2026-05-26): AISDLC-430..434 rolled up OQ-13.1..13.5
+# refinements onto the shipped Phase 1-6 substrate. All refinements
+# reflected in this stub and the runbook.
+
+apiVersion: ai-sdlc.io/v1alpha1
+kind: SignalIngestionConfig
+metadata:
+  name: signal-ingestion
+spec:
+  # Master switch. Flip to \`true\` AFTER:
+  #   1. You have configured at least one working adapter under \`adapters:\`
+  #   2. You have set the \`AI_SDLC_SIGNAL_INGESTION\` env flag (soak window)
+  #   3. You have read docs/operations/signal-ingestion.md for the runbook
+  enabled: false
+
+  # Tier multipliers (RFC-0030 §6.1).
+  # Per-customer-tier weight applied at D1 scoring time. The Churned multiplier
+  # (default 2.0) is intentionally high: churned customers are the strongest
+  # signal of product-market gap. Tune for your deployment heterogeneity —
+  # B2B enterprise platforms typically raise \`enterprise\` (e.g. 5.0) and
+  # flatten \`smb\` / \`free\` (e.g. 0.25). Consumer products typically flatten
+  # all tiers to ~1.0 since tier is less informative.
+  # tierMultipliers:
+  #   enterprise: 3.0
+  #   mid: 1.5
+  #   smb: 1.0
+  #   free: 0.5
+  #   churned: 2.0
+
+  # ICP resonance weights (RFC-0030 §6.2).
+  # Strong = signal source matches declared ICP segments verbatim.
+  # Partial = adjacent segment (e.g. enterprise but wrong industry vertical).
+  # Weak = peripheral (e.g. student account on a B2B product).
+  # icpResonanceWeights:
+  #   strong: 1.5
+  #   partial: 1.0
+  #   weak: 0.5
+
+  # Recency decay half-life in days (RFC-0030 §6.3).
+  # Exponential decay; signals older than ~6 months contribute < 2% of their
+  # original weight at the default. Shorten (e.g. 14) for rapidly-evolving
+  # products; lengthen (e.g. 60) for products with slow signal cycles.
+  # recencyHalfLifeDays: 30
+
+  # Tier 2 significance threshold (RFC-0030 §8).
+  # Tier 2 signals (community, competitive) only feed D1 once a cluster crosses
+  # ALL of these gates. The \`minTier1SignalCount: 1\` gate is the structural
+  # defense against adversarial flooding (OQ-13.5): community buzz without
+  # any direct customer signal stays in the monitor-only zone.
+  # tier2SignificanceThreshold:
+  #   minSignalCount: 5
+  #   minUniqueSources: 3
+  #   minTier1SignalCount: 1
+  #   minClusterAgeDays: 7
+
+  # SA resonance thresholds (RFC-0030 §9).
+  # Per RFC-0029 Principle 4 "The Soul Holds" — high-SA clusters get full
+  # weight, mid-SA discounted, low-SA flagged for review, zero-SA excluded.
+  # When aggregate cluster SA resonance drops below 0.4 sustained for
+  # 3 sprints, the SoulDriftDetected event fires with
+  # \`driftSource: demandMisalignment\`.
+  # saResonanceThresholds:
+  #   fullWeight: 0.7
+  #   discounted: 0.4
+  #   excluded: 0.0
+
+  # Clustering algorithm + similarity threshold (RFC-0030 §7).
+  # \`bm25\` is the deterministic-first default (no external dependencies).
+  # \`embedding\` requires a configured RFC-0019 embedding provider adapter.
+  # Raise \`similarityThreshold\` (closer to 1.0) for stricter clustering;
+  # lower for looser theme aggregation.
+  # clustering:
+  #   algorithm: bm25
+  #   similarityThreshold: 0.6
+
+  # D1 composition weights (RFC-0030 §10 / AISDLC-347 Phase 5).
+  # Non-replacement: signal-pipeline-derived demand and human-authored
+  # backlog-item demand both feed D1. The composer normalises the pair to
+  # sum to 1; default 50/50 keeps neither stream dominant out of the box.
+  # Raise \`signalPipelineWeight\` after the pipeline has soaked and you
+  # trust its output more than manual translation.
+  # d1Composition:
+  #   signalPipelineWeight: 0.5
+  #   backlogItemWeight: 0.5
+
+  # Adapter list (RFC-0030 §5 / OQ-13.1 v0.3 re-walkthrough — AISDLC-430).
+  # v1 ships env-var-based adapters ONLY. OAuth-required adapters (full
+  # Salesforce / HubSpot, Zendesk-with-OAuth) wait for the credential-mgmt
+  # RFC. Adapters declaring \`requiresOAuth: true\` are refused at
+  # registration with Decision: adapter-requires-credential-mgmt-rfc.
+  #
+  # Shipped adapters and their credential env vars:
+  #   - signal-source-support-ticket  → SIGNAL_ZENDESK_PAT
+  #   - signal-source-community-thread → SIGNAL_COMMUNITY_BOT_TOKEN
+  #   - signal-source-in-app-feedback  → SIGNAL_IN_APP_FEEDBACK_API_KEY
+  #   - signal-source-manual           → no credential (see manualEntry block)
+  #
+  # Credential failure Decisions:
+  #   - adapter-credential-not-configured: env var missing → SET the var
+  #   - adapter-credential-rejected: env var present but auth failed → ROTATE
+  # Pipeline continues with remaining valid adapters in both cases (G0).
+  # adapters:
+  #   - signal-source-support-ticket
+  #   - signal-source-community-thread
+  #   - signal-source-in-app-feedback
+
+  # Language acceptance (RFC-0030 OQ-13.2 v0.3 re-walkthrough — AISDLC-431).
+  # Detection: \`franc\` library (deterministic; <10ms per signal; JS-native;
+  # MIT-licensed; 95%+ accuracy on text >50 chars). Language detection runs
+  # at the classifier before any clustering step.
+  # Default [en] — English-only. Orgs with non-English customer bases can
+  # add languages: [en, fr, es, de, ja, ...]. Note the documented trade-off:
+  # BM25 clustering degrades ~15-30% precision without per-language
+  # stopwords/stemming (Robertson & Zaragoza §3.5). LLM ICP-resonance and
+  # embedding clustering are native multi-language (no degradation there).
+  # Non-accepted signals: Decision: signal-language-unsupported — dropped and
+  # logged to catalog for visible-gap metric; pipeline continues (G0).
+  # Opt in knowingly — see docs/operations/signal-ingestion.md §2.5.
+  # acceptedLanguages:
+  #   - en
+
+  # Per-stage data residency enforcement (RFC-0030 OQ-13.3 v0.3 — AISDLC-432).
+  # RFC-0022 owns regime DECLARATION (compliance.yaml). This block gates
+  # ENFORCEMENT at each signal-pipeline stage. All points default ON when
+  # any regime is declared; disable selectively only when your regime allows it
+  # (rare — every override emits SignalIngestionConfigChanged).
+  # residencyEnforcement:
+  #   sourceFromCompliancePosture: true   # derive allowedRegions from RFC-0022
+  #   enforcementPoints:
+  #     fetchSignals: true                # refuse out-of-region signals at adapter
+  #     clustering: true                  # prevent cross-region cluster merging
+  #     storage: true                     # persist residencyRegion field; elevate cross-region read audit
+  #     unifiedCostReport: true           # break out per-region cost attribution
+  #   multiPostureBehavior: union         # GDPR+HIPAA: strictest of both applies
+
+  # Manual-entry anti-gaming (RFC-0030 OQ-13.4 v0.3 re-walkthrough — AISDLC-430).
+  # RFC-0022 OQ-2 audit trail pattern preserved (forced attestedBy +
+  # auto-filled attestedAt). Three additional anti-gaming hooks:
+  #   1. Per-operator daily rate limit (default 10/day). Above cap:
+  #      Decision: manual-signal-rate-limit-exceeded.
+  #   2. Optional evidenceUrl (call recording, ticket URL, transcript link).
+  #      When present, audit trail is materially stronger.
+  #   3. Rolling 7d manual-share quality metric. Above 30% sustained:
+  #      Decision: manual-signal-share-elevated (warning, not block).
+  # manualEntry:
+  #   dailyCapPerOperator: 10             # per-operator per-UTC-day; 0 = disabled
+  #   evidenceUrlOptional: true           # framework treats evidenceUrl as optional
+  #   qualityMetric:
+  #     enabled: true
+  #     windowDays: 7
+  #     shareWarningThreshold: 0.30       # >30% rolling 7d triggers Decision
+
+  # Adversarial-injection defense (RFC-0030 OQ-13.5 v0.3 — AISDLC-433).
+  # Two layers:
+  #   1. Tier 2 significance threshold (§8) — structural floor requiring ≥1
+  #      Tier 1 signal per cluster.
+  #   2. Z-score detector — runtime anomaly layer on rolling 7d baseline.
+  # Trigger: volume > 3σ above baseline AND unique sources in window < 3.
+  # Quarantine: flagged signals recorded but NOT fed to D1; auto-expires 24h.
+  # One-click unquarantine logs Decision: signal-flooding-false-positive for
+  # v2 reputation-weighting calibration. Reputation-weighting deferred to v2
+  # (cold-start unsafe — requires 7+ corpus windows of baseline data).
+  # flooding:
+  #   detection:
+  #     algorithm: z-score               # only z-score supported (AISDLC-433)
+  #     zScoreThreshold: 3.0
+  #     windowMinutes: 60
+  #     minUniqueSourcesForSuspicion: 3
+  #     baselineDays: 7
+  #   quarantine:
+  #     enabled: true
+  #     durationHours: 24
+`;
+/**
+ * Signal-ingestion template set scaffolded by the wizard's
+ * \`--with-signal-ingestion\` / \`--add signal-ingestion\` flag (AISDLC-348).
+ *
+ * Ships the per-org config stub disabled-by-default. The pipeline runtime
+ * lives in \`orchestrator/src/signal-ingestion/\`; this template just gives
+ * adopters the documented config surface to start from.
+ *
+ * Idempotent: existing files at the target paths are skipped by the
+ * dispatcher.
+ */
+export const SIGNAL_INGESTION_TEMPLATES = {
+    files: {
+        '.ai-sdlc/signal-ingestion.yaml': SIGNAL_INGESTION_CONFIG_STUB,
+    },
+};
+/**
+ * Workflow template set scaffolded by `--with-workflows` / `--add workflows`
+ * (AISDLC-261). Bundles all four canonical GitHub Actions workflow files that
+ * an adopter needs for the AI-SDLC framework to function end-to-end:
+ *
+ *   1. `ai-sdlc-gate.yml` — single rollup `ai-sdlc/pr-ready` check (always-on baseline).
+ *   2. `verify-attestation.yml` — DSSE envelope verifier (audit-only).
+ *   3. `ai-sdlc-review.yml` — CI-side reviewer fan-out + `Post Review Results` status.
+ *   4. `auto-enable-auto-merge.yml` — arms auto-merge on every same-repo PR.
+ *
+ * Idempotent: files already present are skipped by default; `--force` overwrites.
+ *
+ * Source of truth: `.github/workflows/` in the ai-sdlc framework repo.
+ * Mirror changes here when the adopter-facing API evolves.
+ */
+export const WORKFLOWS_TEMPLATES = {
+    files: {
+        '.github/workflows/ai-sdlc-gate.yml': AI_SDLC_GATE_WORKFLOW,
+        '.github/workflows/verify-attestation.yml': VERIFY_ATTESTATION_WORKFLOW,
+        '.github/workflows/ai-sdlc-review.yml': AI_SDLC_REVIEW_WORKFLOW,
+        '.github/workflows/auto-enable-auto-merge.yml': AUTO_ENABLE_AUTO_MERGE_WORKFLOW,
+    },
+};
 /**
  * Always-on baseline workflow templates (regardless of wizard answers).
  * Matches AC #4 in AISDLC-143: pipeline.yaml + agent-role.yaml +
  * quality-gate.yaml + autonomy-policy.yaml are scaffolded by `initProject`
  * (existing logic) and the gate workflow is scaffolded by this map.
+ *
+ * AISDLC-305 / Phase 4 (RFC-0025): the quality-monitoring config + the
+ * upstream-report template are part of the BASELINE because they are pure
+ * documentation-as-data (every block commented-out, shipping defaults
+ * documented inline). Adopters get the §13.1 cribsheet by default; the
+ * `.gitignore`-friendly behavior is to commit it as-is and uncomment
+ * blocks per-org as needed.
  */
 export const BASELINE_WORKFLOW_TEMPLATES = {
     files: {
         '.github/workflows/ai-sdlc-gate.yml': AI_SDLC_GATE_WORKFLOW,
+        '.ai-sdlc/quality-monitoring.yaml': QUALITY_MONITORING_CONFIG_STUB,
+        '.ai-sdlc/templates/framework-bug-report.md': FRAMEWORK_BUG_REPORT_TEMPLATE_STUB,
     },
 };
 //# sourceMappingURL=init-templates.js.map