altero 0.1.0__tar.gz

altero-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug report
+description: Something in Altero isn't working right
+labels: [bug]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you do, what did you see, and what did you expect instead?
+      placeholder: Ran `altero switch 2`, got ... — expected ...
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Altero version and install method
+      description: Output of `altero --version`, and whether you installed with uv, pipx, or from source.
+      placeholder: altero 0.1.0, installed with uv
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      description: Credentials are stored differently per platform, so this matters a lot.
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - WSL
+    validations:
+      required: true
+  - type: dropdown
+    id: claude-code
+    attributes:
+      label: How do you run Claude Code?
+      multiple: true
+      options:
+        - CLI (terminal)
+        - VS Code extension
+        - Desktop app
+  - type: textarea
+    id: logs
+    attributes:
+      label: Command output or logs
+      description: Paste the failing command's output — `altero list` for account-state issues, `altero auto` log lines for auto-switch issues. Formatted automatically, no backticks needed. Please redact emails/account identifiers, and never paste access/refresh tokens, API keys, setup tokens, or credential-file/Keychain contents.
+      render: shell

altero-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Report a security vulnerability
+    url: https://github.com/FullContextLabs/Altero/security/advisories/new
+    about: Please report vulnerabilities privately, not as a public issue. See SECURITY.md.

altero-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,16 @@
+name: Feature request
+description: Suggest an improvement or new capability
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem would this solve?
+      description: Describe the situation where you miss this feature — the workflow matters more than the mechanism.
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: What would you like to happen?
+      description: A rough sketch is fine — commands, flags, behavior.

altero-0.1.0/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      github-actions:
+        patterns: ["*"]
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      python-dependencies:
+        patterns: ["*"]

altero-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,117 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: test (${{ matrix.os }}, py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    # macOS: a `security` call can block on an invisible SecurityAgent
+    # dialog; faulthandler below dumps every thread's stack past its budget,
+    # and this is the backstop if even that hangs.
+    timeout-minutes: ${{ matrix.os == 'macos-latest' && 15 || 10 }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        # Matches [project] requires-python (">=3.12") and the classifiers
+        # in pyproject.toml (3.12, 3.13, 3.14).
+        python-version: ['3.12', '3.13', '3.14']
+
+    steps:
+      - uses: actions/checkout@v7
+
+      # uv (not pip) so the PEP 735 dev dependency-group -- pytest,
+      # pytest-asyncio, pytest-xdist -- installs from the committed
+      # lockfile, same as local development.
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      # menubar (rumps) carries its own `sys_platform == 'darwin'` marker,
+      # so the extra resolves to nothing on Linux/Windows -- but only macOS
+      # needs it installed.
+      - name: Install dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: uv sync --locked --extra menubar
+
+      - name: Install dependencies
+        if: runner.os != 'macOS'
+        run: uv sync --locked
+
+      # faulthandler_timeout is set everywhere the whole suite runs on
+      # macOS, matching the previous macos-keychain job: it caught a hung
+      # `security` call that the default timeout alone would only kill
+      # silently.
+      - name: Run tests
+        run: uv run pytest -q ${{ runner.os == 'macOS' && '-o faulthandler_timeout=600' || '' }}
+
+  build-sanity:
+    name: build sanity (sdist + wheel)
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: '3.12'
+          enable-cache: true
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Check distributions with twine
+        run: uv run --with twine twine check dist/*
+
+  widget:
+    name: widget (build, test, lint)
+    runs-on: macos-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Install xcodegen
+        run: brew install xcodegen
+
+      - name: Install swiftlint
+        run: brew install swiftlint
+
+      # Signing.xcconfig is gitignored (per-developer Team ID). The example's
+      # blank DEVELOPMENT_TEAM is fine: the build below is unsigned.
+      - name: Set up Signing.xcconfig
+        working-directory: widget
+        run: cp Signing.xcconfig.example Signing.xcconfig
+
+      - name: Generate Xcode project
+        working-directory: widget
+        run: xcodegen generate
+
+      # Unsigned: CI has no Apple Developer Team ID / certificate. The
+      # golden fixture (tests/fixtures/snapshot_golden.json) is bundled as a
+      # test resource straight from its repo path by project.yml, so the
+      # checkout alone is enough for it to resolve.
+      - name: Build and test (unsigned)
+        working-directory: widget
+        run: |
+          xcodebuild -project AlteroWidget.xcodeproj -scheme AlteroWidgetTests \
+            -destination 'platform=macOS' \
+            CODE_SIGNING_ALLOWED=NO CODE_SIGNING_REQUIRED=NO test
+
+      - name: SwiftLint
+        working-directory: widget
+        run: swiftlint

altero-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v7
+
+      - name: Set up Python
+        uses: actions/setup-python@v7
+        with:
+          python-version: '3.12'
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

altero-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# superpowers session planning artifacts (not part of the project)
+docs/superpowers/
+
+# Xcode (widget/). The .xcodeproj and both Info.plists are generated by
+# XcodeGen; Signing.xcconfig holds the per-developer Team ID. `build/` above
+# already covers build directories.
+widget/*.xcodeproj/
+widget/Signing.xcconfig
+widget/App/Info.plist
+widget/Widget/Info.plist
+DerivedData/
+xcuserdata/
+*.xcuserstate

altero-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

altero-0.1.0/.vscode/launch.json

@@ -0,0 +1,60 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "altero --list",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "altero.cli",
+            "args": ["--list"],
+            "cwd": "${workspaceFolder}",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            },
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "altero --switch",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "altero.cli",
+            "args": ["--switch"],
+            "cwd": "${workspaceFolder}",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            },
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "altero --purge",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "altero.cli",
+            "args": ["--purge"],
+            "cwd": "${workspaceFolder}",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            },
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "altero (custom args)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "altero.cli",
+            "args": ["${input:cliArgs}"],
+            "cwd": "${workspaceFolder}",
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            },
+            "console": "integratedTerminal"
+        }
+    ],
+    "inputs": [
+        {
+            "id": "cliArgs",
+            "type": "promptString",
+            "description": "CLI arguments (e.g., --list, --status, --switch)"
+        }
+    ]
+}