Taskfile.yml

version: '3'

dotenv:
  - .env

tasks:
  default:
    desc: Show available tasks
    cmds:
      - task --list

  fmt:
    desc: Format all Go packages
    cmds:
      - go fmt ./...

  fmt-check:
    desc: Verify tracked Go sources are formatted without modifying the worktree
    cmds:
      # Only tracked sources: a local .cache/ (build and module caches) is
      # gitignored and must never affect the formatting gate.
      - test -z "$(git ls-files -z '*.go' | xargs -0 gofmt -l)"

  lint:
    desc: Run lightweight static checks
    cmds:
      - go vet ./...

  test:
    desc: Run unit tests
    cmds:
      - go test ./...

  build:
    desc: Build all Go packages
    cmds:
      - go build ./...

  generator:
    desc: Fetch upstream metadata, sync models/, and regenerate models_gen.go
    cmds:
      - go run ./cmd/generator {{.CLI_ARGS}}

  generator-check:
    desc: Verify models_gen.go matches the current YAML registry
    cmds:
      - go run ./cmd/generator -cache-only -sync-registry=false -check

  generator-offline:
    desc: Regenerate models_gen.go from YAML and the immutable local cache
    cmds:
      - go run ./cmd/generator -cache-only -sync-registry=false

  translator:
    desc: Incrementally translate missing description_cn fields in models/
    cmds:
      - go run ./cmd/translator {{.CLI_ARGS}}

  cardextract:
    desc: Extract evidence-backed model-card suggestions with an OpenAI-compatible AI
    cmds:
      - go run ./cmd/cardextractor {{.CLI_ARGS}}

  cardextract-batch:
    desc: Resume evidence-backed extraction for every HF-enriched model
    cmds:
      - bash scripts/extract-model-cards.sh

  suggestion:
    desc: Review and explicitly apply evidence-backed metadata suggestions
    cmds:
      - go run ./cmd/suggestionctl {{.CLI_ARGS}}

  codexsuggest:
    desc: Generate a conservative reviewable Codex policy suggestion
    cmds:
      - go run ./cmd/codexsuggest {{.CLI_ARGS}}

  enrich:
    desc: Enrich new or selected model YAML from structured upstream sources
    cmds:
      - go run ./cmd/enricher {{.CLI_ARGS}}

  catalog-audit:
    desc: Audit publisher attribution, official links, and source coverage
    cmds:
      - go run ./cmd/catalogsync -output data/catalog-audit.json {{.CLI_ARGS}}

  catalog-check:
    desc: Verify the committed local catalog audit is current
    cmds:
      - go run ./cmd/catalogsync -check -output data/catalog-audit.json

  catalog-doctor:
    desc: Write a read-only report of non-model and suspicious records
    cmds:
      - go run ./cmd/catalogdoctor -output data/catalog-doctor.json {{.CLI_ARGS}}

  catalog-doctor-check:
    desc: Verify the committed catalog doctor report is current
    cmds:
      - go run ./cmd/catalogdoctor -check -output data/catalog-doctor.json

  catalog-discover:
    desc: Audit the catalog and discover new models from subscribed official Hugging Face organizations
    cmds:
      - go run ./cmd/catalogsync -discover-huggingface -apply-identity-matches -materialize-candidates -limit 5 -output data/catalog-discovery.json {{.CLI_ARGS}}

  catalog-promote:
    desc: Activate fully enriched lifecycle candidate model records
    cmds:
      - go run ./cmd/catalogsync -promote-ready -output data/catalog-audit.json {{.CLI_ARGS}}

  official-identity:
    desc: Corroborate identity from first-party model APIs (requires vendor API keys; dry run unless -- -apply)
    cmds:
      - go run ./cmd/officialsync {{.CLI_ARGS}}

  catalog-backfill:
    desc: One-time exact identity backfill from subscribed official Hugging Face organizations
    cmds:
      - go run ./cmd/catalogsync -discover-huggingface -since 0 -apply-identity-matches -output .cache/catalog-backfill.json {{.CLI_ARGS}}

  site:
    desc: Generate the Argus Model Museum static site for GitHub Pages
    cmds:
      - go run ./cmd/sitegen {{.CLI_ARGS}}

  site-check:
    desc: Build and validate the Argus Model Museum static site without changing the worktree
    cmds:
      - go test ./cmd/sitegen

  codexgen:
    desc: Generate a validated Codex models.json catalog from enriched YAML
    cmds:
      - go run ./cmd/codexgen {{.CLI_ARGS}}

  codexvalidate:
    internal: true
    cmds:
      - go run ./cmd/codexgen -validate

  codexcheck:
    desc: Load the generated catalog through the pinned Codex CLI
    cmds:
      - go run ./cmd/codexcheck {{.CLI_ARGS}}

  codexinstall:
    desc: Download, merge, validate, and configure the latest Codex catalog
    cmds:
      - sh scripts/install-codex-catalog.sh {{.CLI_ARGS}}

  releasecheck:
    desc: Compare current models_gen.go with the latest tag and decide whether a release is needed
    cmds:
      - go run ./cmd/releasecheck {{.CLI_ARGS}}

  sync:
    desc: "End-to-end refresh: fetch/sync once -> translate -> offline generate"
    cmds:
      - task: generator
      - task: translator
      - task: generator-offline

  ci:
    desc: CI-equivalent local checks
    cmds:
      - task: lint
      - task: test
      - task: fmt-check
      - task: build
      - task: codexvalidate
      - task: catalog-check
      - task: catalog-doctor-check
      - task: generator-check
      - task: site-check

  run:
    desc: Run an arbitrary shell command, for example task run -- go test ./...
    cmds:
      - '{{.CLI_ARGS}}'