@mbe24/99problems 0.2.0 → 0.3.1

package/.github/ISSUE_TEMPLATE/01-feature.yml

@@ -0,0 +1,65 @@
+name: Feature request
+description: Propose a new feature or enhancement.
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for proposing a feature. Please describe the problem and the intended design clearly.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem are we solving? Why now?
+      placeholder: Describe the user pain or gap this feature addresses.
+    validations:
+      required: true
+
+  - type: textarea
+    id: design
+    attributes:
+      label: Design
+      description: High-level design and key decisions.
+      placeholder: Describe the architecture, interfaces, or behavior changes.
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: Scope
+      description: In-scope implementation items.
+      placeholder: |
+        - Item 1
+        - Item 2
+        - Item 3
+
+  - type: textarea
+    id: boundary
+    attributes:
+      label: Boundary
+      description: Explicitly out-of-scope items.
+      placeholder: |
+        - Not included in this task
+        - Deferred to follow-up work
+
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: Acceptance Criteria
+      description: Measurable conditions that define done.
+      placeholder: |
+        - Condition 1
+        - Condition 2
+        - Condition 3
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Relevant standards, docs, external constraints, or background.
+      placeholder: Provide context in prose and include useful links.
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/02-bug.yml

@@ -0,0 +1,122 @@
+name: Bug report
+description: Report a bug and provide enough detail to reproduce it.
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please provide a clear reproduction and exact command output to speed up triage.
+
+  - type: textarea
+    id: describe_bug
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+      placeholder: Explain what is broken.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: To Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Run `...`
+        2. Use flags `...`
+        3. Observe error `...`
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: Describe the expected result.
+    validations:
+      required: true
+
+  - type: textarea
+    id: command_output
+    attributes:
+      label: Command + output
+      description: Include the exact command, flags, and relevant stdout/stderr.
+      render: shell
+      placeholder: |
+        99problems ...
+        Error: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots
+      description: If applicable, add terminal screenshots to help explain the problem.
+      placeholder: Paste images or links.
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      description: Which operating system are you using?
+      options:
+        - Windows
+        - macOS
+        - Linux
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: shell
+    attributes:
+      label: Shell
+      description: Which shell are you using?
+      options:
+        - PowerShell
+        - Git Bash
+        - WSL
+        - Bash
+        - Zsh
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: Install method
+      description: How was the CLI installed?
+      options:
+        - npm
+        - cargo
+        - built from source
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: tool_version
+    attributes:
+      label: Tool version
+      description: Output of `99problems --version`.
+      placeholder: 99problems x.y.z
+    validations:
+      required: true
+
+  - type: textarea
+    id: configuration_context
+    attributes:
+      label: Configuration context
+      description: Share relevant `.99problems` instance/platform setup (remove secrets).
+      placeholder: Instance alias, platform, URL/repo/project settings, etc.
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Add any other context about the problem here.
+      placeholder: Related links, logs, constraints, or history.

package/.github/ISSUE_TEMPLATE/99-custom.yml

@@ -0,0 +1,33 @@
+name: Custom issue
+description: Open a custom issue when feature/bug templates do not fit.
+title: "[Custom] "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for requests that do not fit feature or bug reporting.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What is the issue or request?
+      placeholder: Describe the problem clearly.
+    validations:
+      required: true
+
+  - type: textarea
+    id: details
+    attributes:
+      label: Details
+      description: Additional technical details, proposals, or notes.
+      placeholder: Add any implementation or background details.
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: Relevant context, links, standards, or constraints.
+      placeholder: Explain context and include supporting links.
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

package/.github/dependabot.yml

@@ -0,0 +1,20 @@
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "cargo"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    ignore:
+        # These are peer deps of Cargo and should not be automatically bumped
+        - dependency-name: "semver"
+        - dependency-name: "crates-io"
+    rebase-strategy: "disabled"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    rebase-strategy: "disabled"

package/.github/scripts/publish.js

@@ -69,7 +69,7 @@ for (const p of platforms) {
     os: [p.os],
     cpu: [p.cpu],
     main: `bin/${p.binary}`,
-    license: "MIT",
+    license: "Apache-2.0",
     repository: { type: "git", url: "https://github.com/mbe24/99problems" },
   };
   fs.writeFileSync(

package/.github/workflows/ci.yml

@@ -1,10 +1,11 @@
 name: CI
 
 on:
-  push:
-    branches: ["**"]
   pull_request:
-    branches: ["**"]
+    branches: ["main"]
+  push:
+    branches: ["main"]
+    tags: ["v*"]
 
 env:
   CARGO_TERM_COLOR: always
@@ -14,7 +15,7 @@ jobs:
     name: Test
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable
@@ -22,7 +23,7 @@ jobs:
           components: clippy, rustfmt
 
       - name: Cache cargo registry
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cargo/registry
@@ -44,4 +45,29 @@ jobs:
         if: env.GITHUB_TOKEN != ''
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: cargo test -- --include-ignored
+        run: cargo test -- --include-ignored --skip jira_ --skip bitbucket_
+
+  clippy_pedantic:
+    name: Clippy (pedantic, advisory)
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+
+      - name: Cache cargo registry
+        uses: actions/cache@v5
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: ${{ runner.os }}-cargo-
+
+      - name: Clippy pedantic
+        run: cargo clippy --all-targets --no-deps -- -W clippy::pedantic

package/.github/workflows/man-drift.yml

@@ -0,0 +1,26 @@
+name: Man Drift
+
+on:
+  pull_request:
+    branches: ["main"]
+  push:
+    branches: ["main"]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  drift:
+    name: Man page drift check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Generate man pages
+        run: cargo run -- man --output docs/man --section 1
+
+      - name: Check for drift
+        run: git diff --exit-code -- docs/man

package/.github/workflows/release.yml

@@ -17,8 +17,44 @@ env:
   RELEASE_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.version || github.ref_name }}
 
 jobs:
+  validate-release-version:
+    name: Validate release version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Validate release tag format
+        shell: bash
+        run: |
+          if [[ ! "${RELEASE_VERSION}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z]+)*$ ]]; then
+            echo "Release version '${RELEASE_VERSION}' is invalid."
+            echo "Expected format like v0.3.0 (optional prerelease/build suffix allowed)."
+            exit 1
+          fi
+
+      - name: Ensure Cargo.toml version matches release tag
+        shell: bash
+        run: |
+          set -euo pipefail
+          release_version="${RELEASE_VERSION#v}"
+          cargo_version="$(sed -n 's/^version = "\([^"]*\)"/\1/p' Cargo.toml | head -n1)"
+
+          if [[ -z "${cargo_version}" ]]; then
+            echo "Could not read package version from Cargo.toml."
+            exit 1
+          fi
+
+          if [[ "${cargo_version}" != "${release_version}" ]]; then
+            echo "Version mismatch:"
+            echo "  tag version:   ${release_version}"
+            echo "  Cargo.toml:    ${cargo_version}"
+            echo "Update Cargo.toml before creating/pushing the release tag."
+            exit 1
+          fi
+
   build:
     name: Build ${{ matrix.target }}
+    needs: validate-release-version
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
@@ -46,7 +82,7 @@ jobs:
             use_cross: true
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable
@@ -54,7 +90,7 @@ jobs:
           targets: ${{ matrix.target }}
 
       - name: Cache cargo registry
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: |
             ~/.cargo/registry
@@ -71,17 +107,19 @@ jobs:
         run: ${{ matrix.use_cross && 'cross' || 'cargo' }} build --release --target ${{ matrix.target }}
 
       - name: Upload binary artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: binary-${{ matrix.target }}
           path: target/${{ matrix.target }}/release/${{ matrix.binary }}
 
   publish-crates:
     name: Publish to crates.io
-    needs: build
+    needs:
+      - validate-release-version
+      - build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable
@@ -93,18 +131,20 @@ jobs:
 
   publish-npm:
     name: Publish npm packages
-    needs: build
+    needs:
+      - validate-release-version
+      - build
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: "20"
           registry-url: "https://registry.npmjs.org"
 
       - name: Download all binaries
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           path: artifacts/
 

package/CONTRIBUTING.md

@@ -1,74 +1,62 @@
 # 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
+## 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)
+# Optional: install local pre-commit hook (fmt + clippy)
 cp .githooks/pre-commit .git/hooks/pre-commit
-chmod +x .git/hooks/pre-commit  # not needed on Windows
+chmod +x .git/hooks/pre-commit
 
-# 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
+Ignored integration tests (live APIs):
 
-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
+```bash
+cargo test -- --include-ignored --skip jira_
+```
 
-## Project structure
+## Local Quality Gates
 
+Run these before committing:
+
+```bash
+cargo fmt
+cargo clippy --all-targets --no-deps -- -D warnings
+cargo clippy --all-targets --no-deps -- -W clippy::pedantic
+cargo test
 ```
-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)
+
+## Help and Man Pages
+
+The CLI help and man pages are generated from the clap command model.
+
+Regenerate man pages after CLI/help changes:
+
+```bash
+cargo run -- man --output docs/man --section 1
 ```
 
-## Adding a new source
+Verify no drift:
+
+```bash
+git diff -- docs/man
+```
 
-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`
+## Command Module Layout
 
-## Adding a new output format
+Hybrid command-module convention:
 
-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`
+- simple commands: `src/cmd/<name>.rs`
+- complex commands: `src/cmd/<name>/mod.rs` with submodules
 
-## Code of conduct
+## Pull Requests
 
-Be respectful and constructive. We follow the
-[Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+1. Create a feature branch.
+2. Keep commits focused and compile-safe.
+3. Run local quality gates.
+4. Open a PR with problem statement + design summary.