@dotdotdash/afterhours 0.1.0

package/dist/report-2P72ZPRH.js

@@ -0,0 +1,10 @@
+import {
+  renderJson,
+  renderMarkdown,
+  writeReports
+} from "./chunk-UC2WX3XO.js";
+export {
+  renderJson,
+  renderMarkdown,
+  writeReports
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@dotdotdash/afterhours",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Autonomous schedulable system that maintains web codebases",
+  "keywords": [
+    "maintenance",
+    "automation",
+    "dependency-audit",
+    "llm",
+    "devops"
+  ],
+  "license": "MIT",
+  "bin": {
+    "afterhours": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "format": "prettier --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm test && npm run build"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.1",
+    "nodemailer": "^9.0.1",
+    "simple-git": "^3.1.0",
+    "yaml": "^2.6.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/nodemailer": "^8.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}

package/templates/config.yml

@@ -0,0 +1,90 @@
+version: 1
+
+project:
+  type: auto              # auto | website | server | library
+  packageManager: auto    # auto | npm | pnpm | yarn | bun
+  build: auto             # auto-detected, or an explicit command like "npm run build"
+  test: auto              # auto | none | explicit command
+  run: auto               # smoke-run command; ignored for library
+  # runHealthcheck:
+  #   type: http            # http | log | exit
+  #   url: http://localhost:3000/health
+  #   timeoutSec: 30
+
+sandbox:
+  mode: host              # docker | host  (prefer docker in CI, host for local)
+  image: node:20-bookworm # used when mode=docker
+  network: bridge         # bridge | none
+
+schedule:
+  cron: "0 3 * * 1"       # every Monday at 3 AM (informational; consumed by adapters)
+
+platform:
+  provider: github        # github | gitlab | azure | codecommit | gcsr | generic
+  remote: origin
+  baseBranch: main
+  branchPrefix: afterhours/
+  autoMerge: false        # if true, squash-merges when all tasks succeed
+  mergeStrategy: squash   # squash | merge | rebase
+
+llm:
+  provider: anthropic     # anthropic | openai | ollama | github-models | gemini | copilot
+  model: claude-sonnet-4-5
+  apiKeyEnv: ANTHROPIC_API_KEY  # name of env var holding the API key
+  # baseUrlEnv:           # optional override (for Ollama, proxies, etc.)
+  maxTokens: 8000
+  # To use a GitHub Copilot seat for agentic work instead of a direct LLM API key:
+  #   provider: copilot
+  #   model: gpt-4o          # any Copilot-supported chat model
+  #   apiKeyEnv: COPILOT_TOKEN   # a GitHub token for a Copilot-licensed account (can be a
+  #                              # different account than platform.provider's repo-access token,
+  #                              # e.g. an org member's Copilot seat working on a client-owned repo)
+
+agent:
+  mode: builtin           # builtin | external
+  # external:
+  #   cli: aider           # aider | claude | codex
+  #   extraArgs: []
+
+tasks:
+  dependencyAudit:
+    enabled: true
+    securityOnly: false   # true = only upgrade vulnerable/deprecated deps
+    allowMajor: false     # allow major-version bumps
+    notifyOnFailure: true
+  codeOptimization:
+    enabled: true
+    priorityThreshold: high   # low | medium | high | severe
+    notifyOnComplete: false
+  deployment:
+    enabled: false        # enable only when ready to deploy
+    targets: []
+    # Example targets:
+    # - type: npm
+    #   tokenEnv: NPM_TOKEN
+    #   access: public
+    # - type: github-release
+    #   tagFrom: package.json
+    #   generateNotes: true
+  issueTriage:
+    enabled: false        # requires a platform token with issue read/write access (e.g. GITHUB_TOKEN)
+    allowedAuthors:       # usernames allowed to trigger automated issue resolution, or ["*"] for anyone
+      - "*"
+    notifyOnFailure: true
+
+notifications:
+  - type: github          # comments on the PR; opens an issue on failure
+  # - type: email
+  #   toEnv: NOTIFY_EMAIL_TO
+  #   fromEnv: NOTIFY_EMAIL_FROM
+  #   smtp:
+  #     hostEnv: SMTP_HOST
+  #     portEnv: SMTP_PORT
+  #     userEnv: SMTP_USER
+  #     passEnv: SMTP_PASS
+  # - type: webhook
+  #   urlEnv: AFTERHOURS_WEBHOOK_URL
+
+contacts:
+  - name: Maintainer
+    emailEnv: MAINTAINER_EMAIL

package/templates/docker-cron/Dockerfile

@@ -0,0 +1,23 @@
+FROM node:20-bookworm-slim
+
+# Install Docker CLI so afterhours can use the Docker sandbox
+RUN apt-get update && apt-get install -y --no-install-recommends \
+  docker.io \
+  git \
+  && rm -rf /var/lib/apt/lists/*
+
+# Install afterhours globally
+RUN npm install -g afterhours
+
+# Mount repo at /workspace
+WORKDIR /workspace
+
+# The crontab schedules "afterhours run" — copy it in and install
+COPY crontab /etc/cron.d/afterhours
+RUN chmod 0644 /etc/cron.d/afterhours && crontab /etc/cron.d/afterhours
+
+# Secrets are passed via --env-file when running the container:
+#   docker run --env-file .env -v /your/repo:/workspace afterhours-cron
+# Never bake secrets into the image.
+
+CMD ["cron", "-f"]

package/templates/docker-cron/README.md

@@ -0,0 +1,31 @@
+# afterhours Docker + cron adapter
+
+This adapter runs `afterhours run` inside a Docker container on a cron schedule.
+It is suitable for any host that can run Docker (VPS, EC2, bare metal, Raspberry Pi, etc.).
+
+## Quick start
+
+```bash
+# 1. Build the image
+docker build -t afterhours-cron .
+
+# 2. Create a .env file with your secrets (see .env.example at the repo root)
+cp /path/to/afterhours/.env.example .env
+# Edit .env with real values
+
+# 3. Run the container, mounting your target repo
+docker run -d \
+  --name afterhours-cron \
+  --env-file .env \
+  -v /path/to/your/repo:/workspace \
+  -v /var/run/docker.sock:/var/run/docker.sock \
+  afterhours-cron
+```
+
+## Notes
+
+- Secrets are passed via `--env-file`, never baked into the image.
+- The Docker socket mount (`/var/run/docker.sock`) is only needed if you use `sandbox.mode: docker`.
+  For `sandbox.mode: host`, omit it.
+- Adjust the cron schedule in `crontab` to match `.afterhours/config.yml`.
+- View logs: `docker logs afterhours-cron`

package/templates/docker-cron/crontab

@@ -0,0 +1,3 @@
+# Run afterhours every Monday at 3 AM UTC
+# Adjust to match the cron in .afterhours/config.yml
+0 3 * * 1 root cd /workspace && afterhours run >> /var/log/afterhours.log 2>&1

package/templates/github-actions.yml

@@ -0,0 +1,50 @@
+name: afterhours
+
+on:
+  schedule:
+    - cron: "0 3 * * 1"  # every Monday at 3 AM UTC; adjust to match .afterhours/config.yml
+  workflow_dispatch:       # allow manual trigger from GitHub Actions UI
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install afterhours
+        run: npm install -g afterhours || npx afterhours --version
+
+      - name: Run afterhours
+        run: npx afterhours run
+        env:
+          # Platform token — map your repo secret to the env var afterhours expects
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+          # LLM provider — choose one and map the right secret
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+          # Notifications (optional)
+          NOTIFY_EMAIL_TO: ${{ secrets.NOTIFY_EMAIL_TO }}
+          NOTIFY_EMAIL_FROM: ${{ secrets.NOTIFY_EMAIL_FROM }}
+          SMTP_HOST: ${{ secrets.SMTP_HOST }}
+          SMTP_PORT: ${{ secrets.SMTP_PORT }}
+          SMTP_USER: ${{ secrets.SMTP_USER }}
+          SMTP_PASS: ${{ secrets.SMTP_PASS }}
+          AFTERHOURS_WEBHOOK_URL: ${{ secrets.AFTERHOURS_WEBHOOK_URL }}
+
+          # Deployment (optional)
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
+          REGISTRY_PASS: ${{ secrets.REGISTRY_PASS }}
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+          VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+          GIT_SHA: ${{ github.sha }}