night-orch 0.1.0

package/dist/workers/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/workers/timeout.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GACA,OAAO,CAAC,UAAU,CAAC,CAgCrB"}

package/dist/workers/timeout.js

@@ -0,0 +1,37 @@
+import { execa } from 'execa';
+/**
+ * Execute a command with timeout. Kills process group on timeout.
+ */
+export async function execWithTimeout(command, args, opts) {
+    const start = Date.now();
+    try {
+        const result = await execa(command, args, {
+            cwd: opts.cwd,
+            env: opts.env,
+            timeout: opts.timeoutMs,
+            reject: false,
+            input: opts.stdin,
+            killSignal: 'SIGTERM',
+            forceKillAfterDelay: 5000,
+        });
+        return {
+            stdout: result.stdout,
+            stderr: result.stderr,
+            exitCode: result.exitCode ?? 0,
+            timedOut: result.timedOut ?? false,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const durationMs = Date.now() - start;
+        const e = err;
+        return {
+            stdout: e.stdout ?? '',
+            stderr: e.stderr ?? String(err),
+            exitCode: e.exitCode ?? 1,
+            timedOut: e.timedOut ?? (durationMs >= opts.timeoutMs),
+            durationMs,
+        };
+    }
+}
+//# sourceMappingURL=timeout.js.map

package/dist/workers/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/workers/timeout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAU7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,IAAc,EACd,IAKC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACxC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,SAAS;YACvB,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,SAAS;YACrB,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAA;QAEF,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;YAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,KAAK;YAClC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAA;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;QACrC,MAAM,CAAC,GAAG,GAAkF,CAAA;QAC5F,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;YACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC;YAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;YACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC;YACtD,UAAU;SACX,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/workers/types.d.ts

@@ -0,0 +1,120 @@
+import type { TriageLevel } from '../discovery/triage.js';
+import type { AgentEvent } from '../events/types.js';
+export type AgentRole = 'planner' | 'coder' | 'reviewer';
+export type ReviewVerdict = 'APPROVED' | 'CHANGES_REQUIRED' | 'BLOCKED';
+export interface WorkerTaskInput {
+    runId?: string;
+    phase?: string;
+    role: AgentRole;
+    worktreePath: string;
+    prompt: string;
+    profile: WorkerProfileInput;
+    timeoutSeconds: number;
+    env: Record<string, string>;
+    onEvent?: (event: AgentEvent) => void;
+    /** Session ID from a prior phase to continue the conversation. */
+    continueSessionId?: string | null;
+}
+export interface WorkerProfileInput {
+    type: string;
+    pricingModel?: string;
+    command: string;
+    args: string[];
+    workerTimeoutSeconds: number;
+    minimalEnv: boolean;
+    runtimeWrapper: string | null;
+    env: Record<string, string>;
+}
+export interface WorkerTaskResult {
+    rawOutput: string;
+    exitCode: number;
+    timedOut: boolean;
+    durationMs: number;
+    parsed: PlannerOutput | CoderOutput | ReviewerOutput | null;
+    parseError: string | null;
+    /** Session/thread ID for continuing the conversation in subsequent phases. */
+    sessionId: string | null;
+    /** Real token counts from the agent, when available. */
+    tokenUsage?: {
+        promptTokens: number;
+        completionTokens: number;
+    };
+}
+export interface PlannerOutput {
+    objective: string;
+    assumptions: string[];
+    filesToChange: string[];
+    steps: PlanStep[];
+    risks: string[];
+    testStrategy: string;
+}
+export interface PlanStep {
+    order: number;
+    description: string;
+    files: string[];
+}
+export interface CoderOutput {
+    summary: string;
+    changedFiles: string[];
+    remainingUncertainty: string | null;
+    blockers: string[] | null;
+}
+export interface ReviewerOutput {
+    verdict: ReviewVerdict;
+    summary: string;
+    findings: ReviewFinding[];
+    definitionOfDoneCheck: {
+        issueAddressed: boolean;
+        testsPassing: boolean;
+        noBlockingFindings: boolean;
+    };
+}
+export interface ReviewFinding {
+    severity: 'critical' | 'major' | 'minor';
+    message: string;
+    suggestedFix: string | null;
+}
+export interface VerifyResult {
+    command: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    passed: boolean;
+}
+export interface PromptContext {
+    role: AgentRole;
+    issue: {
+        number: number;
+        title: string;
+        body: string;
+        labels: string[];
+    };
+    repo: {
+        name: string;
+        baseBranch: string;
+    };
+    plan: string | null;
+    diff: string | null;
+    reviewFindings: ReviewFinding[] | null;
+    verifyResults: VerifyResult[] | null;
+    iteration: {
+        current: number;
+        max: number;
+        isRetry: boolean;
+    };
+    triageLevel: TriageLevel;
+    followup?: {
+        type: string;
+        summary: string | null;
+        context: string;
+    } | null;
+}
+export interface WorkerAdapter {
+    runTask(input: WorkerTaskInput): Promise<WorkerTaskResult>;
+    checkAvailability(): Promise<{
+        available: boolean;
+        version: string | null;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"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"}

package/dist/workers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":""}

package/docker-compose.example.yaml

@@ -0,0 +1,29 @@
+services:
+  prometheus:
+    image: prom/prometheus:latest
+    ports:
+      - "9091:9090"
+    volumes:
+      - ./monitoring/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - prometheus-data:/prometheus
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    restart: unless-stopped
+
+  grafana:
+    image: grafana/grafana:latest
+    ports:
+      - "3001:3000"
+    volumes:
+      - ./monitoring/grafana/provisioning:/etc/grafana/provisioning:ro
+      - ./monitoring/grafana/dashboards:/var/lib/grafana/dashboards:ro
+      - grafana-data:/var/lib/grafana
+    environment:
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_ADMIN_PASSWORD:?GRAFANA_ADMIN_PASSWORD is required}
+      - GF_AUTH_ANONYMOUS_ENABLED=true
+      - GF_AUTH_ANONYMOUS_ORG_ROLE=Viewer
+    restart: unless-stopped
+
+volumes:
+  prometheus-data:
+  grafana-data:

package/examples/config.example.yaml

@@ -0,0 +1,256 @@
+version: 1
+
+github:
+  tokenEnv: GITHUB_TOKEN
+  apiBaseUrl: https://api.github.com
+  pollIntervalSeconds: 300
+  appMentions:
+    claude:
+      enabled: true
+      commentTemplate: "@claude Please review this PR and apply fixes if needed."
+    codex:
+      enabled: false
+      commentTemplate: "@codex please review and patch any remaining issues."
+
+storage:
+  dbPath: ~/.config/night-orch/state.db
+  worktreeRoot: ~/code/.night-orch/worktrees
+  logsRoot: ~/code/.night-orch/logs
+  autoCleanup:
+    enabled: true
+    intervalMinutes: 60
+  retention:
+    worktreeAgeDays: 7
+    detailDays: 30
+    archiveDays: 90
+
+notifications:
+  channels:
+    - type: console
+    # - type: webhook
+    #   urlEnv: NIGHT_ORCH_WEBHOOK_URL
+    # - type: discord
+    #   urlEnv: NIGHT_ORCH_DISCORD_WEBHOOK_URL
+  events:
+    onRunStarted: false
+    onBlocked: true
+    onPrReady: true
+    onPrUpdated: true
+    onError: true
+    onRetryExhausted: true
+
+loop:
+  maxReviewIterations: 4
+  maxTotalAgentPasses: 10
+  stopOnPlannerFailure: true
+  requireVerificationPass: true
+  reviewApprovalKeyword: APPROVED
+  reviewNeedsChangesKeyword: CHANGES_REQUIRED
+  blockOnAmbiguousReview: true
+  maxAutoRetries: 3
+  # decompose: true              # Enable issue decomposition into sub-tasks
+  # maxSubtasks: 5               # Max sub-tasks per decomposition
+  # maxConcurrentSubtasks: 3     # Max parallel sub-task worktrees
+
+security:
+  maxChangedFiles: 50
+  maxChangedLines: 5000
+  maxDailyCostUsd: 50
+  maxCostPerRunUsd: 10
+
+cost:
+  model: pay-per-use # or: subscription
+  # Optional: model-aware pricing overrides.
+  # If omitted, pay-per-use uses built-in defaults and subscription defaults
+  # USD estimation to 0.00.
+  # pricing:
+  #   defaultModel: claude-sonnet-4
+  #   models:
+  #     claude-sonnet-4:
+  #       inputUsdPerMillionTokens: 3
+  #       outputUsdPerMillionTokens: 15
+  #       minuteUsd: 0.008
+  #     gpt-5:
+  #       inputUsdPerMillionTokens: 1.25
+  #       outputUsdPerMillionTokens: 10
+  #       minuteUsd: 0.01
+
+workerProfiles:
+  claude-default:
+    type: claude
+    # pricingModel: claude-sonnet-4
+    command: claude
+    args:
+      - -p
+    workerTimeoutSeconds: 1800
+    env: {}
+  codex-default:
+    type: codex
+    # pricingModel: gpt-5
+    command: codex
+    args:
+      - exec
+      - --json
+    workerTimeoutSeconds: 1800
+    env: {}
+  # gemini-acp:
+  #   type: acp
+  #   command: gemini            # acpx agent name
+  #   args: []
+  #   workerTimeoutSeconds: 1800
+
+metrics:
+  enabled: true
+  port: 9090
+  host: 0.0.0.0
+
+observability:
+  agentStreaming: true
+  eventRetention: 1000
+  sessionLogs: true
+  sessionLogRetention: 7
+
+commentCommands:
+  enabled: true
+  requireCollaborator: false
+
+# workflows:
+#   minimal:
+#     steps:
+#       - { type: worker, id: code, role: coder }
+#       - { type: verify, id: verify }
+#       - { type: worker, id: review, role: reviewer }
+#       - { type: decide, id: decide, onIterate: code }
+#   fast-trivial:
+#     roles:
+#       coder: codex
+#       reviewer: codex
+#     agents:
+#       codex: codex-fast
+#     steps:
+#       - { type: worker, id: code, role: coder }
+#       - { type: verify, id: verify }
+#       - { type: decide, id: decide, onIterate: code, requireReview: false }
+#   with-security-review:
+#     steps:
+#       - { type: worker, id: plan, role: planner, skipWhen: trivial }
+#       - { type: worker, id: code, role: coder, continueFrom: plan }
+#       - { type: verify, id: verify }
+#       - { type: worker, id: security, role: reviewer }
+#       - { type: worker, id: review, role: reviewer }
+#       - { type: decide, id: decide, onIterate: code }
+
+repos:
+  - repo: myorg/myrepo
+    forge: github
+    # linkedProjects:
+    #   - myorg/tracker
+    localPath: ~/code/myrepo
+    maxConcurrentRuns: 1
+    baseBranch: main
+    branchPrefix: orch
+    labels:
+      ready:
+        - orch:ready
+      running: orch:running
+      blocked:
+        - orch:blocked
+        - orch:needs-human
+      reviewReady: orch:review-ready
+      error: orch:error
+      retry: orch:retry
+      planning: orch:planning
+      # mergeQueued: orch:merge-queued
+      # merging: orch:merging
+      # mergeFailed: orch:merge-failed
+    # Optional kanban-state flow. If triggerLabel is present on an issue,
+    # these labels are used for state transitions instead of labels above.
+    # kanban:
+    #   triggerLabel: flow:kanban
+    #   labels:
+    #     ready: [kanban:todo]
+    #     running: kanban:doing
+    #     blocked: kanban:blocked
+    #     needsHuman: kanban:needs-human
+    #     reviewReady: kanban:review
+    #     error: kanban:error
+    #     retry: kanban:retry
+    #     planning: kanban:planning
+    #     mergeQueued: kanban:merge-queued
+    #     merging: kanban:merging
+    #     mergeFailed: kanban:merge-failed
+    planning:
+      prdDirectory: docs/prd
+    # Optional per-label metadata overrides used by `night-orch labels-init`
+    labelConfig:
+      orch:ready:
+        color: 0E8A16
+        description: Queued for night-orch processing
+      orch:running:
+        color: FBCA04
+        description: Currently being processed by night-orch
+      orch:planning:
+        color: C2E0C6
+        description: Planning-only mode (PRD markdown only)
+    defaults:
+      planner: claude
+      coder: codex
+      reviewer: claude
+      doneMode: pr-ready
+      notifyPriority: normal
+      prMentions:
+        - claude
+    environment:
+      defaultMode: shared
+      # dedicated:
+      #   compose:
+      #     file: docker-compose.dev.yml
+      #     services: [db, redis]
+      #     projectName: "orch-{issue}"
+      #   env:
+      #     copyFrom: .env
+      #     overrides:
+      #       PORT: "{auto:5101-5199}"
+      #       DATABASE_URL: "postgres://localhost:5432/myapp_orch_{issue}"
+      #   healthcheck: "curl -f http://localhost:{port}/health"
+      #   teardownOnComplete: true
+      shared:
+        requireRunning: true
+        healthcheck: "curl -f http://localhost:3000/health"
+      bootstrap:
+        - command: pnpm install --frozen-lockfile
+          when: always
+        # - command: bundle exec rails db:prepare
+        #   when: always
+        #   failureHints:
+        #     - contains: 'role "app_user" does not exist'
+        #       message: 'Create PostgreSQL role "app_user" locally before rerunning bootstrap.'
+        #       output: combined
+    verify:
+      - pnpm lint
+      - pnpm typecheck
+      - pnpm test
+    prompts:
+      plannerSystem: .night-orch/prompts/planner-system.md
+      coderSystem: .night-orch/prompts/coder-system.md
+      reviewerSystem: .night-orch/prompts/reviewer-system.md
+    selectors:
+      includeLabelsAny:
+        - orch:ready
+      excludeLabelsAny:
+        - orch:blocked
+        - orch:error
+    agents:
+      claude: claude-default
+      codex: codex-default
+    # workflow: minimal           # Reference a named workflow
+    # workflowByTriage:
+    #   trivial: fast-trivial
+    #   standard: minimal
+    # mergeQueue:
+    #   enabled: true
+    #   batchSize: 5
+    #   mergeMethod: merge
+    #   retryFlakyOnce: true
+    #   requireApproval: true
+    #   stagingBranchPrefix: orch/staging

package/examples/night-orch.service

@@ -0,0 +1,40 @@
+[Unit]
+Description=night-orch — Nightly GitHub issue orchestrator
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=%i
+WorkingDirectory=%h/apps/night-orch
+Environment=HOME=%h
+Environment=XDG_CONFIG_HOME=%h/.config
+Environment=XDG_DATA_HOME=%h/.local/share
+Environment=XDG_CACHE_HOME=%h/.cache
+Environment=XDG_STATE_HOME=%h/.local/state
+Environment=MISE_CONFIG_DIR=%h/.config/mise
+Environment=MISE_DATA_DIR=%h/.local/share/mise
+Environment=MISE_CACHE_DIR=%h/.cache/mise
+Environment=MISE_STATE_DIR=%h/.local/state/mise
+Environment=PNPM_HOME=%h/.local/share/pnpm
+Environment=PATH=%h/.local/bin:%h/.local/share/pnpm:%h/.local/share/mise/shims:/usr/local/bin:/usr/bin:/bin
+EnvironmentFile=%h/apps/night-orch/.env
+ExecStart=%h/.local/share/pnpm/night-orch serve --config %h/.night-orch/config.yaml
+Restart=on-failure
+RestartSec=30
+
+# Prevent sleep during active runs
+ExecStartPre=/usr/bin/systemd-inhibit --what=sleep --who=night-orch --why="Processing issues" --mode=delay sleep 0
+
+# Resource limits
+MemoryMax=2G
+CPUQuota=200%
+
+# Security hardening
+NoNewPrivileges=yes
+ProtectSystem=strict
+ProtectHome=read-only
+ReadWritePaths=%h/.config %h/.cache %h/.local %h/.night-orch %h/apps
+
+[Install]
+WantedBy=default.target

package/monitoring/grafana/dashboards/night-orch.json

@@ -0,0 +1,140 @@
+{
+  "annotations": { "list": [] },
+  "editable": true,
+  "fiscalYearStartMonth": 0,
+  "graphTooltip": 1,
+  "links": [],
+  "panels": [
+    {
+      "title": "Active Runs",
+      "type": "stat",
+      "gridPos": { "h": 4, "w": 4, "x": 0, "y": 0 },
+      "targets": [{ "expr": "night_orch_active_runs", "refId": "A" }],
+      "fieldConfig": { "defaults": { "thresholds": { "steps": [{ "color": "green", "value": null }, { "color": "yellow", "value": 2 }, { "color": "red", "value": 5 }] } } }
+    },
+    {
+      "title": "Eligible Issues",
+      "type": "stat",
+      "gridPos": { "h": 4, "w": 4, "x": 4, "y": 0 },
+      "targets": [{ "expr": "sum(night_orch_eligible_issues)", "refId": "A" }],
+      "fieldConfig": { "defaults": { "thresholds": { "steps": [{ "color": "blue", "value": null }] } } }
+    },
+    {
+      "title": "Daily Cost (USD)",
+      "type": "stat",
+      "gridPos": { "h": 4, "w": 4, "x": 8, "y": 0 },
+      "targets": [{ "expr": "night_orch_daily_cost_usd", "refId": "A" }],
+      "fieldConfig": { "defaults": { "unit": "currencyUSD", "thresholds": { "steps": [{ "color": "green", "value": null }, { "color": "yellow", "value": 15 }, { "color": "red", "value": 25 }] } } }
+    },
+    {
+      "title": "Runs Total",
+      "type": "stat",
+      "gridPos": { "h": 4, "w": 4, "x": 12, "y": 0 },
+      "targets": [{ "expr": "sum(night_orch_runs_total)", "refId": "A" }],
+      "fieldConfig": { "defaults": { "thresholds": { "steps": [{ "color": "purple", "value": null }] } } }
+    },
+    {
+      "title": "Verify Pass Rate",
+      "type": "gauge",
+      "gridPos": { "h": 4, "w": 4, "x": 16, "y": 0 },
+      "targets": [{ "expr": "night_orch_verify_runs_total{result=\"pass\"} / (night_orch_verify_runs_total{result=\"pass\"} + night_orch_verify_runs_total{result=\"fail\"})", "refId": "A" }],
+      "fieldConfig": { "defaults": { "unit": "percentunit", "min": 0, "max": 1, "thresholds": { "steps": [{ "color": "red", "value": null }, { "color": "yellow", "value": 0.5 }, { "color": "green", "value": 0.8 }] } } }
+    },
+    {
+      "title": "PRs Created / Updated",
+      "type": "stat",
+      "gridPos": { "h": 4, "w": 4, "x": 20, "y": 0 },
+      "targets": [
+        { "expr": "night_orch_pr_operations_total{type=\"created\"}", "legendFormat": "Created", "refId": "A" },
+        { "expr": "night_orch_pr_operations_total{type=\"updated\"}", "legendFormat": "Updated", "refId": "B" }
+      ],
+      "fieldConfig": { "defaults": { "thresholds": { "steps": [{ "color": "green", "value": null }] } } }
+    },
+    {
+      "title": "Runs by Status",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 4 },
+      "targets": [
+        { "expr": "increase(night_orch_runs_total[1h])", "legendFormat": "{{status}}", "refId": "A" }
+      ]
+    },
+    {
+      "title": "Agent Invocations",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 4 },
+      "targets": [
+        { "expr": "increase(night_orch_agent_invocations_total[1h])", "legendFormat": "{{role}} ({{adapter}})", "refId": "A" }
+      ]
+    },
+    {
+      "title": "Run Duration",
+      "type": "histogram",
+      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 12 },
+      "targets": [
+        { "expr": "night_orch_run_duration_seconds_bucket", "legendFormat": "{{le}}", "refId": "A", "format": "heatmap" }
+      ],
+      "fieldConfig": { "defaults": { "unit": "s" } }
+    },
+    {
+      "title": "Phase Duration (p50 / p95)",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 12 },
+      "targets": [
+        { "expr": "histogram_quantile(0.5, rate(night_orch_phase_duration_seconds_bucket[5m]))", "legendFormat": "p50 {{phase}}", "refId": "A" },
+        { "expr": "histogram_quantile(0.95, rate(night_orch_phase_duration_seconds_bucket[5m]))", "legendFormat": "p95 {{phase}}", "refId": "B" }
+      ],
+      "fieldConfig": { "defaults": { "unit": "s" } }
+    },
+    {
+      "title": "Agent Duration (p50 / p95)",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 8, "x": 0, "y": 20 },
+      "targets": [
+        { "expr": "histogram_quantile(0.5, rate(night_orch_agent_duration_seconds_bucket[5m]))", "legendFormat": "p50 {{role}}/{{adapter}}", "refId": "A" },
+        { "expr": "histogram_quantile(0.95, rate(night_orch_agent_duration_seconds_bucket[5m]))", "legendFormat": "p95 {{role}}/{{adapter}}", "refId": "B" }
+      ],
+      "fieldConfig": { "defaults": { "unit": "s" } }
+    },
+    {
+      "title": "Verify Duration",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 8, "x": 8, "y": 20 },
+      "targets": [
+        { "expr": "histogram_quantile(0.5, rate(night_orch_verify_duration_seconds_bucket[5m]))", "legendFormat": "p50", "refId": "A" },
+        { "expr": "histogram_quantile(0.95, rate(night_orch_verify_duration_seconds_bucket[5m]))", "legendFormat": "p95", "refId": "B" }
+      ],
+      "fieldConfig": { "defaults": { "unit": "s" } }
+    },
+    {
+      "title": "Estimated Cost by Agent",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 8, "x": 16, "y": 20 },
+      "targets": [
+        { "expr": "increase(night_orch_estimated_cost_dollars[1h])", "legendFormat": "{{repo}} / {{agent}}", "refId": "A" }
+      ],
+      "fieldConfig": { "defaults": { "unit": "currencyUSD" } }
+    },
+    {
+      "title": "Loop Iterations",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 12, "x": 0, "y": 28 },
+      "targets": [
+        { "expr": "increase(night_orch_loop_iterations_total[1h])", "legendFormat": "{{repo}}", "refId": "A" }
+      ]
+    },
+    {
+      "title": "Notifications",
+      "type": "timeseries",
+      "gridPos": { "h": 8, "w": 12, "x": 12, "y": 28 },
+      "targets": [
+        { "expr": "increase(night_orch_notifications_total[1h])", "legendFormat": "{{channel}} ({{result}})", "refId": "A" }
+      ]
+    }
+  ],
+  "schemaVersion": 39,
+  "tags": ["night-orch"],
+  "templating": { "list": [] },
+  "time": { "from": "now-6h", "to": "now" },
+  "title": "Night-Orch",
+  "uid": "night-orch-overview"
+}

package/monitoring/grafana/provisioning/dashboards/dashboards.yml

@@ -0,0 +1,10 @@
+apiVersion: 1
+
+providers:
+  - name: Night-Orch
+    type: file
+    disableDeletion: false
+    updateIntervalSeconds: 30
+    options:
+      path: /var/lib/grafana/dashboards
+      foldersFromFilesStructure: false

package/monitoring/grafana/provisioning/datasources/prometheus.yml

@@ -0,0 +1,9 @@
+apiVersion: 1
+
+datasources:
+  - name: Prometheus
+    type: prometheus
+    access: proxy
+    url: http://prometheus:9090
+    isDefault: true
+    editable: false

package/monitoring/prometheus.yml

@@ -0,0 +1,8 @@
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+scrape_configs:
+  - job_name: night-orch
+    static_configs:
+      - targets: ["host.docker.internal:9090"]