feat: initial otko import

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,56 @@
+name: Bug report
+description: Report a defect in OTKO
+labels: ["bug"]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: A clear and concise description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Open a new project
+        2. Click 'Draw Frame'
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: OTKO version
+      placeholder: 0.0.1
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: 3.11.7
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Windows
+        - macOS
+        - Linux
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Console output / traceback
+      render: shell

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,31 @@
+name: Feature request
+description: Propose a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: What engineering problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+    validations:
+      required: true
+  - type: dropdown
+    id: phase
+    attributes:
+      label: Roadmap phase this fits into
+      options:
+        - "Phase 1 — Core Model"
+        - "Phase 2 — OpenSees Service"
+        - "Phase 3 — 3D Viewport"
+        - "Phase 4 — Modeling Tools"
+        - "Phase 5 — Properties"
+        - "Phase 6 — Analysis Pipeline"
+        - "Phase 7 — Post-processing"
+        - "Phase 8 — Earthquake Engineering"
+        - "Out of scope / new"

.github/pull_request_template.md

@@ -0,0 +1,26 @@
+## Summary
+
+<!-- One sentence: what does this change? -->
+
+## Linked issue
+
+Closes #
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / cleanup
+- [ ] Documentation
+- [ ] CI / tooling
+
+## Architectural checklist
+
+- [ ] No `from PySide6` in `core/` or `services/`
+- [ ] No `import openseespy` in `core/` or `views/`
+- [ ] Public functions have type hints + docstrings
+- [ ] Heavy work runs off the GUI thread
+
+## Testing
+
+<!-- How was this verified? Reference tests added or analytical checks. -->

.github/workflows/ci.yml

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install ruff mypy
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+
+  test:
+    needs: lint
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Linux Qt deps
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libegl1 libxkbcommon-x11-0 libxcb-icccm4 \
+            libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 \
+            libxcb-shape0 libxcb-sync1 libxcb-xfixes0 libxcb-xinerama0 \
+            libxcb-cursor0 libdbus-1-3 libgl1 libxkbcommon0 xvfb
+      - run: pip install -e ".[dev]"
+      - name: Run tests (Linux, headless)
+        if: runner.os == 'Linux'
+        run: xvfb-run -a pytest --cov --cov-report=xml -m "not slow"
+      - name: Run tests (Win/Mac)
+        if: runner.os != 'Linux'
+        run: pytest --cov --cov-report=xml -m "not slow"

.github/workflows/ci.yml.disabled

@@ -0,0 +1,48 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: pip install ruff mypy
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+
+  test:
+    needs: lint
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Linux Qt deps
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libegl1 libxkbcommon-x11-0 libxcb-icccm4 \
+            libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 \
+            libxcb-shape0 libxcb-sync1 libxcb-xfixes0 libxcb-xinerama0 \
+            libxcb-cursor0 libdbus-1-3 libgl1 libxkbcommon0 xvfb
+      - run: pip install -e ".[dev]"
+      - name: Run tests (Linux, headless)
+        if: runner.os == 'Linux'
+        run: xvfb-run -a pytest --cov --cov-report=xml -m "not slow"
+      - name: Run tests (Win/Mac)
+        if: runner.os != 'Linux'
+        run: pytest --cov --cov-report=xml -m "not slow"