@mbe24/99problems 0.1.0

package/.githooks/pre-commit

@@ -0,0 +1,22 @@
+#!/bin/sh
+# Pre-commit hook: format check + clippy
+# Install: this file is already at .git/hooks/pre-commit
+# For new clones run: cp .githooks/pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
+
+set -e
+
+echo "→ cargo fmt --check"
+cargo fmt --check || {
+  echo ""
+  echo "  Formatting issues found. Run 'cargo fmt' to fix them, then re-stage."
+  exit 1
+}
+
+echo "→ cargo clippy"
+cargo clippy --no-deps -- -D warnings || {
+  echo ""
+  echo "  Clippy warnings found. Fix them before committing."
+  exit 1
+}
+
+echo "✓ Pre-commit checks passed"

package/.github/logo.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120">
+  <rect width="120" height="120" rx="24" fill="#6D28D9"/>
+  <text
+    x="60"
+    y="82"
+    font-family="'Segoe UI', Arial, sans-serif"
+    font-size="68"
+    font-weight="800"
+    text-anchor="middle"
+    fill="#FFFFFF"
+    letter-spacing="-3">9P</text>
+</svg>

package/.github/scripts/publish.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+// Builds per-platform npm packages from CI artifacts and publishes them,
+// then updates + publishes the main wrapper package.
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const version = process.env.VERSION?.replace(/^v/, "");
+if (!version) throw new Error("VERSION env var is required (e.g. v0.1.0)");
+
+const platforms = [
+  {
+    pkg: "@mbe24/99problems-win32-x64",
+    dir: "npm-win32-x64",
+    artifact: "artifacts/binary-x86_64-pc-windows-msvc/99problems.exe",
+    binary: "99problems.exe",
+    os: "win32",
+    cpu: "x64",
+  },
+  {
+    pkg: "@mbe24/99problems-linux-x64",
+    dir: "npm-linux-x64",
+    artifact: "artifacts/binary-x86_64-unknown-linux-gnu/99problems",
+    binary: "99problems",
+    os: "linux",
+    cpu: "x64",
+  },
+  {
+    pkg: "@mbe24/99problems-darwin-x64",
+    dir: "npm-darwin-x64",
+    artifact: "artifacts/binary-x86_64-apple-darwin/99problems",
+    binary: "99problems",
+    os: "darwin",
+    cpu: "x64",
+  },
+  {
+    pkg: "@mbe24/99problems-darwin-arm64",
+    dir: "npm-darwin-arm64",
+    artifact: "artifacts/binary-aarch64-apple-darwin/99problems",
+    binary: "99problems",
+    os: "darwin",
+    cpu: "arm64",
+  },
+  {
+    pkg: "@mbe24/99problems-linux-arm64",
+    dir: "npm-linux-arm64",
+    artifact: "artifacts/binary-aarch64-unknown-linux-gnu/99problems",
+    binary: "99problems",
+    os: "linux",
+    cpu: "arm64",
+  },
+];
+
+for (const p of platforms) {
+  const pkgDir = path.join(p.dir);
+  fs.mkdirSync(path.join(pkgDir, "bin"), { recursive: true });
+
+  // Copy binary
+  fs.copyFileSync(p.artifact, path.join(pkgDir, "bin", p.binary));
+  if (p.os !== "win32") {
+    fs.chmodSync(path.join(pkgDir, "bin", p.binary), 0o755);
+  }
+
+  // Write package.json
+  const pkgJson = {
+    name: p.pkg,
+    version,
+    description: `${p.os}-${p.cpu} binary for @mbe24/99problems`,
+    os: [p.os],
+    cpu: [p.cpu],
+    main: `bin/${p.binary}`,
+    license: "MIT",
+    repository: { type: "git", url: "https://github.com/mbe24/99problems" },
+  };
+  fs.writeFileSync(
+    path.join(pkgDir, "package.json"),
+    JSON.stringify(pkgJson, null, 2) + "\n"
+  );
+
+  console.log(`Publishing ${p.pkg}@${version} ...`);
+  execSync("npm publish --access public", { cwd: pkgDir, stdio: "inherit" });
+}
+
+// Update main package.json version + optionalDependencies versions
+const mainPkg = JSON.parse(fs.readFileSync("package.json", "utf8"));
+mainPkg.version = version;
+for (const p of platforms) {
+  mainPkg.optionalDependencies[p.pkg] = version;
+}
+fs.writeFileSync("package.json", JSON.stringify(mainPkg, null, 2) + "\n");
+
+console.log(`Publishing @mbe24/99problems@${version} ...`);
+execSync("npm publish --access public", { stdio: "inherit" });

package/.github/social-preview.svg

@@ -0,0 +1,82 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 640" width="1280" height="640">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1280" y2="640" gradientUnits="userSpaceOnUse">
+      <stop offset="0%" stop-color="#0F0720"/>
+      <stop offset="100%" stop-color="#1C0B38"/>
+    </linearGradient>
+    <radialGradient id="logoglow" cx="50%" cy="50%" r="50%">
+      <stop offset="0%" stop-color="#7C3AED" stop-opacity="0.4"/>
+      <stop offset="100%" stop-color="#7C3AED" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1280" height="640" fill="url(#bg)"/>
+
+  <!-- Decorative circles -->
+  <circle cx="1220" cy="60"  r="320" fill="#6D28D9" opacity="0.07"/>
+  <circle cx="60"  cy="610" r="220" fill="#5B21B6" opacity="0.07"/>
+
+  <!-- Soft glow behind logo -->
+  <ellipse cx="220" cy="320" rx="240" ry="240" fill="url(#logoglow)"/>
+
+  <!-- Logo mark -->
+  <rect x="70" y="180" width="300" height="300" rx="44" fill="#6D28D9"/>
+  <text
+    x="220" y="372"
+    font-family="'Segoe UI', Arial, sans-serif"
+    font-size="160" font-weight="900"
+    text-anchor="middle" fill="#FFFFFF"
+    letter-spacing="-8">9P</text>
+
+  <!-- Vertical divider -->
+  <line x1="440" y1="100" x2="440" y2="540" stroke="#6D28D9" stroke-width="1" opacity="0.35"/>
+
+  <!-- Title -->
+  <text
+    x="472" y="234"
+    font-family="'Segoe UI', Arial, sans-serif"
+    font-size="86" font-weight="800"
+    fill="#FFFFFF" letter-spacing="-3">99problems</text>
+
+  <!-- Tagline -->
+  <text
+    x="474" y="282"
+    font-family="'Segoe UI', Arial, sans-serif"
+    font-size="28" font-weight="400"
+    fill="#A78BFA">AI-friendly access to GitHub issues</text>
+
+  <!-- Feature pills -->
+  <rect x="474" y="306" width="116" height="30" rx="6" fill="#2D1260"/>
+  <text x="532" y="326" font-family="'Segoe UI', Arial, sans-serif" font-size="14" text-anchor="middle" fill="#C4B5FD">JSON · YAML</text>
+
+  <rect x="600" y="306" width="116" height="30" rx="6" fill="#2D1260"/>
+  <text x="658" y="326" font-family="'Segoe UI', Arial, sans-serif" font-size="14" text-anchor="middle" fill="#C4B5FD">5 platforms</text>
+
+  <rect x="726" y="306" width="186" height="30" rx="6" fill="#2D1260"/>
+  <text x="819" y="326" font-family="'Segoe UI', Arial, sans-serif" font-size="14" text-anchor="middle" fill="#C4B5FD">GitHub search syntax</text>
+
+  <!-- Terminal window -->
+  <rect x="472" y="352" width="762" height="216" rx="12" fill="#0D0520" stroke="#3B1D7A" stroke-width="1.5"/>
+
+  <!-- Terminal chrome bar -->
+  <rect x="472" y="352" width="762" height="36" rx="12" fill="#1A0A38"/>
+  <rect x="472" y="370" width="762" height="18" fill="#1A0A38"/>
+  <circle cx="502" cy="370" r="7" fill="#FF5F57"/>
+  <circle cx="526" cy="370" r="7" fill="#FFBD2E"/>
+  <circle cx="550" cy="370" r="7" fill="#28C840"/>
+  <text x="760" y="375" font-family="'Segoe UI', Arial, sans-serif" font-size="13" text-anchor="middle" fill="#6B4FA0">zsh</text>
+
+  <!-- Install line -->
+  <text x="496" y="418" font-family="'Courier New', monospace" font-size="17" fill="#6D28D9">$</text>
+  <text x="514" y="418" font-family="'Courier New', monospace" font-size="17" fill="#94A3B8"> npm install -g @mbe24/99problems</text>
+
+  <!-- Command line -->
+  <text x="496" y="458" font-family="'Courier New', monospace" font-size="17" fill="#6D28D9">$</text>
+  <text x="514" y="458" font-family="'Courier New', monospace" font-size="17" fill="#E2E8F0"> 99problems -q </text>
+  <text x="672" y="458" font-family="'Courier New', monospace" font-size="17" fill="#86EFAC">"state:closed repo:owner/repo"</text>
+  <text x="514" y="482" font-family="'Courier New', monospace" font-size="17" fill="#E2E8F0">   -o conversations.json</text>
+
+  <!-- Output line -->
+  <text x="496" y="524" font-family="'Courier New', monospace" font-size="17" fill="#34D399">✓ Wrote 262 conversations to conversations.json</text>
+</svg>

package/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+    branches: ["**"]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: ${{ runner.os }}-cargo-
+
+      - name: Check formatting
+        run: cargo fmt --check
+
+      - name: Clippy
+        run: cargo clippy --no-deps -- -D warnings
+
+      - name: Unit tests
+        run: cargo test
+
+      - name: Integration tests
+        if: env.GITHUB_TOKEN != ''
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: cargo test -- --include-ignored

package/.github/workflows/release.yml

@@ -0,0 +1,115 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version to release (e.g. v0.1.0)"
+        required: true
+        type: string
+
+env:
+  CARGO_TERM_COLOR: always
+  # Resolve version from tag push or manual input
+  RELEASE_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.version || github.ref_name }}
+
+jobs:
+  build:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - target: x86_64-pc-windows-msvc
+            os: windows-latest
+            npm_pkg: "@mbe24/99problems-win32-x64"
+            binary: "99problems.exe"
+          - target: x86_64-unknown-linux-gnu
+            os: ubuntu-latest
+            npm_pkg: "@mbe24/99problems-linux-x64"
+            binary: "99problems"
+          - target: x86_64-apple-darwin
+            os: macos-latest
+            npm_pkg: "@mbe24/99problems-darwin-x64"
+            binary: "99problems"
+          - target: aarch64-apple-darwin
+            os: macos-latest
+            npm_pkg: "@mbe24/99problems-darwin-arm64"
+            binary: "99problems"
+          - target: aarch64-unknown-linux-gnu
+            os: ubuntu-latest
+            npm_pkg: "@mbe24/99problems-linux-arm64"
+            binary: "99problems"
+            use_cross: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-${{ matrix.target }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: ${{ runner.os }}-${{ matrix.target }}-cargo-
+
+      - name: Install cross (for cross-compilation)
+        if: matrix.use_cross
+        run: cargo install cross --locked
+
+      - name: Build binary
+        run: ${{ matrix.use_cross && 'cross' || 'cargo' }} build --release --target ${{ matrix.target }}
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: binary-${{ matrix.target }}
+          path: target/${{ matrix.target }}/release/${{ matrix.binary }}
+
+  publish-crates:
+    name: Publish to crates.io
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Publish to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+        run: cargo publish --no-verify
+
+  publish-npm:
+    name: Publish npm packages
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts/
+
+      - name: Publish platform packages and main package
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          VERSION: ${{ env.RELEASE_VERSION }}
+        run: node .github/scripts/publish.js

package/CONTRIBUTING.md

@@ -0,0 +1,74 @@
+# Contributing to 99problems
+
+Thank you for taking the time to contribute! 🎉
+
+## Ways to contribute
+
+- **Bug reports** — open an issue describing what happened and what you expected
+- **Feature requests** — open an issue with the `enhancement` label
+- **Pull requests** — see the workflow below
+
+## Development setup
+
+```bash
+# Prerequisites: Rust stable (1.85+), cargo
+git clone https://github.com/mbe24/99problems
+cd 99problems
+
+# Install the pre-commit hook (runs cargo fmt + clippy before each commit)
+cp .githooks/pre-commit .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit  # not needed on Windows
+
+# Build
+cargo build
+
+# Run unit tests
+cargo test
+
+# Run integration tests (requires a GitHub token)
+export GITHUB_TOKEN=ghp_your_token
+cargo test -- --include-ignored
+```
+
+## Pull request workflow
+
+1. Fork the repo and create a branch: `git checkout -b my-feature`
+2. Make your changes and add tests where appropriate
+3. Run `cargo test` — all tests must pass
+4. Run `cargo clippy` and `cargo fmt --check` — no new warnings
+5. Open a pull request with a clear description of what and why
+
+## Project structure
+
+```
+src/
+  main.rs          # CLI entry point (clap)
+  config.rs        # Dotfile config loading
+  model.rs         # Shared data types (Conversation, Comment)
+  source/
+    mod.rs         # Source trait + Query builder
+    github_issues.rs  # GitHub Issues API client
+  format/
+    mod.rs         # Formatter trait
+    json.rs        # JSON output
+    yaml.rs        # YAML output
+tests/
+  integration.rs   # Live API tests (#[ignore] by default)
+```
+
+## Adding a new source
+
+1. Create `src/source/my_source.rs` implementing the `Source` trait
+2. Register it in `src/source/mod.rs`
+3. Add a variant to `SourceKind` in `src/main.rs`
+
+## Adding a new output format
+
+1. Create `src/format/my_format.rs` implementing the `Formatter` trait
+2. Register it in `src/format/mod.rs`
+3. Add a variant to `OutputFormat` in `src/main.rs`
+
+## Code of conduct
+
+Be respectful and constructive. We follow the
+[Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).