Developer Workflow

This page is the quick daily loop for LexiShift contributors.

Quick navigation:

• Home

  Developer

  Architecture

  Release

  Diagrams

Prerequisites

• Python 3.10+
• Node.js 20+
• Chrome (for extension tests)

First-Time Setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
npm --prefix scripts run hooks:install

Packaging deps for GUI build validation:

pip install -r requirements-build.txt

Daily Validation Loop

npm --prefix scripts run check

Feature-state audit:

npm --prefix scripts run check:state

Windows parity audit:

npm --prefix scripts run check:windows:parity

Build Safety

npm --prefix scripts run build

Hosted-runner build normalization:

npm --prefix scripts run build:ci:report

Hosted macOS CI runs the full npm --prefix scripts run build:report path; build:ci:report is the explicit non-macOS partial lane.

Run Surfaces

Desktop app:

python apps/gui/src/main.py

BetterDiscord plugin build:

node apps/betterdiscord-plugin/build_plugin.js

Chrome extension:

1. Open chrome://extensions.
2. Enable Developer mode.
3. Load unpacked extension folder apps/chrome-extension/.

Canonical Developer References

• Developer docs hub: ../developer/README.md
• Developer handbook: ../developer/developer_reference.md
• AI-assisted quality loop: ../developer/ai_workflow.md
• GenAI workflow architecture: ../developer/genai_workflow_architecture.md
• Feature state ledger: ../developer/feature_state_matrix.md
• Local setup detail: ../developer/local_setup.md
• Script categories: ../../scripts/README.md

Quality Automation

Rulegen/POS workflow wrappers:

python3 scripts/testing/rulegen_pair_audit_cycle.py --pairs en-es
python3 scripts/testing/rulegen_auto_audit.py --base-ref origin/main

Local Pages Preview

cd /Users/takeyayuki/Documents/projects/LexiShift/docs
bundle install
bundle exec jekyll serve --livereload --host 127.0.0.1 --port 4000 --source .

Open:

• http://127.0.0.1:4000/LexiShift/