![acac-cli](https://github.com/RyosukeDTomita/acac-cli/blob/main/assets/header.png)

[![test](https://github.com/RyosukeDTomita/acac-cli/actions/workflows/test.yml/badge.svg)](https://github.com/RyosukeDTomita/acac-cli/actions/workflows/test.yml)
[![release](https://github.com/RyosukeDTomita/acac-cli/actions/workflows/release.yml/badge.svg)](https://github.com/RyosukeDTomita/acac-cli/actions/workflows/release.yml)
[![npm downloads](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/RyosukeDTomita/acac-cli/badges/downloads.json)](https://www.npmjs.com/package/acac-cli)
[![Socket score](https://socket.dev/api/badge/npm/package/acac-cli)](https://socket.dev/npm/package/acac-cli)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/RyosukeDTomita/acac-cli/badge)](https://scorecard.dev/viewer/?uri=github.com/RyosukeDTomita/acac-cli)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## ABOUT

[AtCoder](https://atcoder.jp/)の直近のAC数とACした問題をCLIから確認する[Haskell](https://www.haskell.org/)製CLIツール。

[ccusage](https://ccusage.com/)にインスピレーションを受けて開発しました。

AC履歴の取得には [AtCoder Problems API](https://github.com/kenkoooo/AtCoderProblems/blob/main/doc/api.md) を利用しています。

---

## HOW TO USE

```shell
npx acac-cli <atcoder-username>
┌──────────────────┬────┬───────────────────────────────────────────────────┐
│ Date             │ AC │ Problems                                          │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ 2026-05-26 (Tue) │ 2  │ abc081B abc290A                                   │
│ 2026-05-29 (Fri) │ 1  │ abc342C                                           │
│ 2026-05-30 (Sat) │ 6  │ abc460A abc460B abc460C abc460D awc0001A awc0001B │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ week total       │ 9  │                                                   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ 2026-05-31 (Sun) │ 1  │ abc460C                                           │
│ 2026-06-01 (Mon) │ 1  │ abc460D                                           │
│ 2026-06-06 (Sat) │ 3  │ abc461A abc461B abc461C                           │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ week total       │ 5  │                                                   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ 2026-06-07 (Sun) │ 1  │ abc461C                                           │
│ 2026-06-08 (Mon) │ 1  │ abc144B                                           │
│ 2026-06-09 (Tue) │ 5  │ abc106B abc120B abc122B abc136B abc150B           │
│ 2026-06-10 (Wed) │ 1  │ abc057C                                           │
│ 2026-06-11 (Thu) │ 1  │ abc095A                                           │
│ 2026-06-12 (Fri) │ 1  │ sumitrust2019D                                    │
│ 2026-06-13 (Sat) │ 3  │ abc462A abc462B abc462C                           │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ week total       │ 13 │                                                   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ 2026-06-15 (Mon) │ 5  │ APG4bA APG4bPythonA abc128C abc462B abc462D       │
│ 2026-06-17 (Wed) │ 3  │ abc145C abc147C abc150C                           │
│ 2026-06-18 (Thu) │ 2  │ abc054C abc448B                                   │
│ 2026-06-19 (Fri) │ 5  │ abc054C abc245B abc273A abc425B awc0001B          │
│ 2026-06-20 (Sat) │ 6  │ abc029C abc153D abc247C abc463A abc463B abc463C   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ week total       │ 21 │                                                   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ 2026-06-22 (Mon) │ 2  │ abc292B abc350B                                   │
├──────────────────┼────┼───────────────────────────────────────────────────┤
│ week total       │ 2  │                                                   │
└──────────────────┴────┴───────────────────────────────────────────────────┘
```

直近の AC 履歴を週ごとのテーブルで表示する。

### supported

以下のバイナリを作成。

| OS | binary type | 実機検証済み |
| ------- | ----------- | ------------ |
| Linux | linux-x64 | ✅ |
| Linux | linux-arm64 | |
| macOS | darwin-arm64 | ✅ |
| macOS | darwin-x64 | |
| Windows | win32-x64 | ✅ |

✅ 以外の環境で実機検証できた方は、ぜひ [Issue](https://github.com/RyosukeDTomita/acac/issues) で連絡してください。

その他の環境をお使いの方はIssueに要望/PRをいただけると幸いですが、[For Developer Memo](#for-developer-memo)を見てセットアップすることも可能です。

### Supply chain / build transparency

- すべてのバイナリは [acac-cli](https://github.com/RyosukeDTomita/acac-cli) のソースから GitHub Actions 上でビルドする。手元のマシンからは publish しない。
  - Linux(linux-x64 / linux-arm64)は Nix による再現可能な musl 静的ビルド(`nix build .#static`)。
  - macOS / Windows は各 OS のネイティブ runner 上で GHC 9.12.2 + cabal でビルドする。
- npm への publish は CI が **provenance 付き**(`--provenance`・OIDC trusted publishing)で行う。各リリースは実行された workflow と commit に紐づけて検証できる。
- リリースは `v*.*.*` タグから GitHub の **Immutable Releases** で作成する(リリースは CI bot が作成し、手動では作らない)。
- GitHub Release の各バイナリは **cosign(keyless)で署名**する。`acac-<os>-<arch>` ごとに署名 `.sig` と証明書 `.pem` を添付し、さらにリリース全体の SLSA **provenance**(`acac.intoto.jsonl`)を同梱する。
- プラットフォーム別バイナリは `acac-<os>-<arch>` という `optionalDependency` として配布し、本体パッケージのランタイム依存は持たない。

---

## For Developer Memo

### Initial Set Up

```shell
nix develop
```

### run locally

`nix develop` のシェル内で cabal から実行する。

```shell
cabal run acac -- <atcoder-username>
```

```shell
# デバックならrunghcの方が気楽かも
runghc -isrc -iapp app/Main.hs <atcoder-username>
```

flake から直接実行することもできる。

```shell
nix run . -- <atcoder-username>
```

### run test

```shell
runghc -isrc test/Spec.hs
```

### formatter

treefmt(ormolu / nixfmt / mdformat)でまとめて整形する。

```shell
nix fmt
```

### Release

`v*.*.*` タグを push すると、GitHub Release への成果物アップロードと npm publish が走る。

#### 1. GitHub Secretsの設定

- `CACHIX_AUTH_TOKEN`

#### 2. Cachix に静的ビルドを seed する

CI は配布用の musl 静的バイナリをCachix(`acac`)から取得する(ソースからの再ビルドは60分級でタイムアウトするため)。
そのため、タグを切る前に、現在の静的ビルドをCachixへseedしておく必要がある。

```shell
# 初回のみ token を設定(以降は不要)
cachix authtoken <CACHIX_AUTH_TOKEN>

nix build .#static
cachix push acac ./result
```

以下を実行し、200ならOK。404なら未seedなのでpushする

```shell
hash=$(basename "$(readlink -f result)" | cut -d- -f1)
curl -s -o /dev/null -w "%{http_code}\n" "https://acac.cachix.org/$hash.narinfo"
```

##### いつ seed し直す必要があるか

`.#static` の derivation が変わった時だけ。具体的には次を変更した場合:

- `src/`・`app/`・`test/`・`acac.cabal`(= cabal パッケージのソース)
- `flake.lock`(依存の更新)
- `flake.nix` のうち **`.#static` に影響する部分**(依存・`fileset`・ghc バージョン・`pkgsStatic` 設定など)

逆に **README・docs・npm・`flake.nix` の devShell やコメントだけ**の変更では seed し直し不要
(`callCabal2nix` のソースを `fileset` で `src/app/test/acac.cabal` に絞っているため)。
判断に迷ったら、上の narinfo 確認で 404 なら push、で確実。

#### 3. タグを切って push する

```shell
git tag v0.1.0
git push origin v0.1.0
```