lumos-identity-cli 0.0.0.dev1__tar.gz

lumos_identity_cli-0.0.0.dev1/.cursor/Dockerfile

@@ -0,0 +1,8 @@
+FROM public.ecr.aws/lumos/devcontainer/base:latest
+
+# Set environment variables for proper terminal functionality
+ENV TERM=xterm-256color
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Ensure proper shell environment
+ENV SHELL=/bin/zsh

lumos_identity_cli-0.0.0.dev1/.cursor/rules/commit-message.mdc

@@ -0,0 +1,158 @@
+---
+description: Angular-style commit message guidelines. Apply when writing git commit messages.
+globs:
+alwaysApply: false
+---
+
+# Commit Message Format
+
+Follow the Angular commit message convention for all commits. This format creates an easier-to-read commit history and enables automated changelog generation.
+
+## Structure
+
+```
+<type>(<scope>): <short summary>
+
+<body>
+
+<footer>
+```
+
+## Header Format (Required)
+
+```
+<type>(<scope>): <short summary>
+```
+
+- **type**: Required. See types below.
+- **scope**: Optional. The area of the codebase affected.
+- **summary**: Required. Present tense, no capitalization, no period at the end.
+
+### Commit Types
+
+| Type         | Description                                                                                         |
+| ------------ | --------------------------------------------------------------------------------------------------- |
+| **feat**     | A new feature                                                                                       |
+| **fix**      | A bug fix                                                                                           |
+| **docs**     | Documentation only changes                                                                          |
+| **style**    | Changes that do not affect the meaning of the code (formatting, whitespace)                         |
+| **refactor** | A code change that neither fixes a bug nor adds a feature                                           |
+| **perf**     | A code change that improves performance                                                             |
+| **test**     | Adding missing tests or correcting existing tests                                                   |
+| **build**    | Changes that affect the build system or external dependencies                                       |
+| **ci**       | Changes to CI configuration files and scripts                                                       |
+| **chore**    | Other changes that don't modify src or test files                                                   |
+| **revert**   | Reverts a previous commit                                                                           |
+
+### Summary Rules
+
+- Use imperative, present tense: "change" not "changed" nor "changes"
+- Don't capitalize the first letter
+- No period (.) at the end
+- Keep under 72 characters
+
+## Body (Optional but Recommended)
+
+- Use imperative, present tense
+- Explain the **motivation** for the change
+- Explain **why** you are making the change, not just what
+- Compare previous behavior with new behavior if helpful
+- Must be at least 20 characters if included
+- Wrap at 72 characters
+
+## Footer (Optional)
+
+Used for:
+- Breaking changes
+- Deprecations
+- Issue references
+
+### Breaking Changes
+
+```
+BREAKING CHANGE: <summary>
+
+<description + migration instructions>
+
+Fixes #<issue number>
+```
+
+### Deprecations
+
+```
+DEPRECATED: <what is deprecated>
+
+<description + recommended update path>
+
+Closes #<pr number>
+```
+
+### Issue References
+
+```
+Fixes #123
+Closes #456
+Refs #789
+```
+
+## Examples
+
+### Feature with scope
+```
+feat(cli): add verbose logging option
+
+Add --verbose flag to enable detailed output during command execution.
+This helps users debug issues with API calls.
+
+Closes #42
+```
+
+### Bug fix
+```
+fix(auth): handle expired token refresh correctly
+
+Previously, expired tokens would cause a crash instead of
+triggering a refresh flow. Now the client properly catches
+the expiration and requests a new token.
+
+Fixes #128
+```
+
+### Documentation
+```
+docs: update README with installation steps
+```
+
+### Breaking change
+```
+feat(api): change response format to JSON
+
+BREAKING CHANGE: API responses are now JSON instead of XML.
+
+Migrate by updating response parsers to handle JSON format.
+See migration guide in docs/migration-v2.md.
+
+Closes #200
+```
+
+### Revert
+```
+revert: feat(cli): add verbose logging option
+
+This reverts commit abc1234.
+
+The verbose mode was causing performance issues in production.
+```
+
+## Quick Reference
+
+✅ Good:
+- `feat(auth): add OAuth2 support`
+- `fix: resolve memory leak in worker pool`
+- `docs: add API reference for new endpoints`
+
+❌ Bad:
+- `Fixed bug` (no type, past tense, vague)
+- `feat: Added new feature.` (past tense, has period)
+- `FEAT: Add Feature` (wrong case)
+- `feat(auth)add oauth` (missing colon after scope)

lumos_identity_cli-0.0.0.dev1/.cursor/rules/docs.mdc

@@ -0,0 +1,69 @@
+---
+description: Guidelines for editing documentation files. Apply when creating or modifying docs, README, or documentation content.
+globs:
+  - README.md
+  - docs/**
+alwaysApply: false
+---
+
+# Documentation Guidelines
+
+## Editable Files
+
+Only edit documentation in these locations:
+
+| Location | Purpose |
+|----------|---------|
+| `README.md` | Project overview and quickstart |
+| `docs/src/*.md` | Detailed documentation source files |
+
+## Never Edit Directly
+
+**Never edit `docs/*.md` files directly.** These are auto-generated from Sphinx source files and will be overwritten.
+
+## Building Docs
+
+After editing any files in `docs/src/`, rebuild the documentation:
+
+```bash
+make -C docs docs
+```
+
+This generates:
+- `docs/*.md` - Markdown output for GitHub viewing
+- `docs/src/_build/html/` - HTML documentation
+
+## README Guidelines
+
+The README should be:
+
+- **Concise**: Brief project overview, not exhaustive documentation
+- **Quickstart focused**: Get users running in minutes
+- **A gateway**: Link to detailed docs in `docs/` for deeper topics
+
+### README Structure
+
+1. Project title and badges
+2. One-paragraph description
+3. Quick installation
+4. Basic usage example
+5. Links to detailed documentation in `docs/`
+
+### Linking to Detailed Docs
+
+For topics that need more detail, link to the full docs:
+
+```markdown
+For more details, see the [Installation Guide](docs/installation.md).
+
+See the [CLI Reference](docs/cli-reference.md) for all available commands.
+```
+
+## Sphinx Source Files
+
+When editing `docs/src/*.md`:
+
+- Follow existing formatting conventions
+- Use proper Sphinx/MyST markdown syntax
+- Include cross-references where appropriate
+- Always rebuild with `make -C docs docs` after changes

lumos_identity_cli-0.0.0.dev1/.devcontainer/devcontainer.json

@@ -0,0 +1,31 @@
+{
+	"image": "public.ecr.aws/lumos/devcontainer/base:latest",
+	"mounts": [
+	  "source=${localEnv:HOME}/.cursor/,target=/home/vscode/.cursor/,type=bind",
+	  "source=lumos-cli-devcontainer-venv,target=${containerWorkspaceFolder}/.venv,type=volume",
+	  "source=lumos-cli-devcontainer-data,target=/home/vscode/devcontainer-data,type=volume"
+	],
+	"initializeCommand": {
+	  "cursor": "mkdir -p ${HOME}/.cursor/"
+	},
+	"onCreateCommand": {
+	  "git_safe": "git config --global --add safe.directory ${containerWorkspaceFolder}",
+	  "venv": "sudo chown -R vscode:vscode ${containerWorkspaceFolder}/.venv"
+	},
+	"customizations": {
+	  "vscode": {
+		"extensions": [
+		  "ms-python.python",
+		  "anysphere.cursorpyright",
+		  "GitHub.vscode-pull-request-github",
+		  "charliermarsh.ruff",
+		  "eamodio.gitlens",
+		  "tamasfe.even-better-toml"
+  		],
+		"settings": {
+		  // Devcontainer specific settings
+		  "terminal.integrated.defaultProfile.linux": "zsh"
+		}
+	  }
+	}
+}

lumos_identity_cli-0.0.0.dev1/.github/workflows/build.yml

@@ -0,0 +1,259 @@
+name: Build
+
+on:
+  workflow_call:
+    inputs:
+      version:
+        description: "Version to build (x.x.x)"
+        type: string
+        required: false
+        default: ''
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+
+  validate-docs:
+    name: Validate Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10.6'
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --group docs
+
+      - name: Build documentation
+        run: make docs
+
+      - name: Check for uncommitted documentation changes
+        run: |
+          if [ -n "$(git status --porcelain docs/)" ]; then
+            echo "::error::Generated documentation is out of date. Please run 'make -C docs docs' and commit the changes."
+            echo ""
+            echo "The following files have uncommitted changes:"
+            git status --porcelain docs/
+            echo ""
+            echo "Diff:"
+            git diff docs/
+            exit 1
+          fi
+          echo "✅ Documentation is up to"
+
+      - name: Rdme Dry Run
+        env:
+          RDME_API_KEY: ${{ secrets.RDME_API_KEY }}
+        run: |
+          npm install -g rdme
+          rdme docs upload docs/src/_build/rdme/ --dry-run
+
+  lint:
+    name: Lint and Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10.6'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --group dev
+
+      - name: Run ruff linter
+        shell: bash
+        run: uv run ruff check .
+
+      - name: Run ruff formatter check
+        shell: bash
+        run: uv run ruff format --check .
+
+      - name: Run basedpyright type checker
+        shell: bash
+        run: uv run basedpyright
+
+  test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10.6'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --group dev
+
+      - name: Run tests
+        run: uv run pytest tests/ -v
+
+  python-package:
+    name: Python Package
+    needs:
+      - lint
+      - test
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10.6'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: Update version
+        shell: bash
+        if: inputs.version != ''
+        run: uv version ${{ inputs.version }}
+
+      - name: Build
+        shell: bash
+        run: |
+          uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist-v${{ inputs.version || 'dev' }}
+          path: dist/
+          retention-days: 90
+
+
+  build-binaries:
+    name: ${{ matrix.platform }} Binary
+    needs:
+      - lint
+      - test
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu22-2cpu-amd64
+            platform: linux-amd64
+          - runner: ubuntu22-2cpu-arm64
+            platform: linux-arm64
+          - runner: macos-latest
+            platform: macos-arm64
+          - runner: windows-latest
+            platform: windows
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10.6'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: Update version
+        shell: bash
+        if: inputs.version != ''
+        run: uv version ${{ inputs.version }}
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --group build
+
+      - name: Build binary
+        shell: bash
+        run: |
+          uv run pyinstaller src/lumos/__main__.py --name lumos
+          VERSION="${{ inputs.version || 'dev' }}"
+          tar -czf lumos-${{ matrix.platform }}-v${VERSION}.tar.gz -C ./dist/lumos .
+
+      - name: Upload artifacts to workflow
+        uses: actions/upload-artifact@v4
+        with:
+          name: lumos-${{ matrix.platform }}-v${{ inputs.version || 'dev' }}
+          path: lumos-${{ matrix.platform }}-v${{ inputs.version || 'dev' }}.tar.gz
+          retention-days: 90
+
+  test-binaries:
+    name: Test ${{ matrix.platform }} Binary
+    needs: build-binaries
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu22-2cpu-amd64
+            platform: linux-amd64
+          - runner: ubuntu22-2cpu-arm64
+            platform: linux-arm64
+          - runner: macos-latest
+            platform: macos-arm64
+          - runner: windows-latest
+            platform: windows
+
+    steps:
+      - name: Download binary artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: lumos-${{ matrix.platform }}-v${{ inputs.version || 'dev' }}
+
+      - name: Extract and test binary (Unix)
+        if: matrix.platform != 'windows'
+        shell: bash
+        run: |
+          tar -xzf lumos-${{ matrix.platform }}-v${{ inputs.version || 'dev' }}.tar.gz
+          chmod +x lumos
+          ./lumos --version
+
+      - name: Extract and test binary (Windows)
+        if: matrix.platform == 'windows'
+        shell: pwsh
+        run: |
+          tar -xzf lumos-${{ matrix.platform }}-v${{ inputs.version || 'dev' }}.tar.gz
+          .\lumos.exe --version