fix(dev): improve local/devcontainer setup

Add explicit setuptools packaging config to support editable installs in flat repo layout.

Update devcontainer bootstrap to install argus in editable mode and improve quick-start commands.

Refresh onboarding workflow steps to include venv creation/activation and editable install.

Author: eFAILution

.ai/workflows.yaml

@@ -167,9 +167,18 @@ contributor_workflows:
       - action: "Clone repository"
         command: "git clone <repo-url> && cd argus"
 
+      - action: "Create virtual environment"
+        command: "python3 -m venv .venv"
+
+      - action: "Activate virtual environment"
+        command: "source .venv/bin/activate"
+
       - action: "Install Python dependencies"
         command: "pip install -r requirements.txt"
 
+      - action: "Install Argus CLI in editable mode"
+        command: "pip install -e ."
+
       - action: "Run tests to verify setup"
         command: "pytest"
     alternative: "Use Dev Container (recommended)"

.devcontainer/README.md

@@ -18,7 +18,7 @@ This project includes a dev container configuration for consistent development e
 2. Open this repository in VS Code
 3. Click "Reopen in Container" when prompted (or run command: `Dev Containers: Reopen in Container`)
 4. Wait for the container to build (~2-3 minutes first time)
-5. All dependencies are ready! Run `npm test`
+5. All dependencies are ready! Run `argus --version` then `npm test`
 
 ### Option 2: GitHub Codespaces
 
@@ -57,6 +57,9 @@ pre-commit install
 # All tests
 npm test
 
+# Verify Argus CLI
+argus --version
+
 # With coverage
 npm run test:coverage
 npm run test:coverage:js

.devcontainer/setup.sh

@@ -22,6 +22,7 @@ source .dev.venv/bin/activate
 echo "Installing Python dependencies..."
 pip install --upgrade pip
 pip install -r requirements.txt
+pip install -e .
 pip install pre-commit
 
 # Setup pre-commit hooks (using absolute path)
@@ -33,8 +34,9 @@ pre-commit install --hook-type pre-push
 echo "Development environment ready!"
 echo ""
 echo "Quick start:"
+echo "  argus --version           # Verify CLI entrypoint"
 echo "  pytest                    # Run all tests"
-echo "  pytest                    # Run tests with coverage"
+echo "  pytest --cov              # Run tests with coverage"
 echo "  pre-commit run --all-files # Run all hooks"
 echo ""
 echo "Note: Python venv (.dev.venv) is auto-activated in new terminals"

pyproject.toml

@@ -1,3 +1,25 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "argus-security"
+version = "0.7.0"
+description = "Argus unified security scanning SDK and CLI"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "PyYAML>=6.0",
+    "requests>=2.31.0",
+]
+
+[project.scripts]
+argus = "argus.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["argus*"]
+exclude = ["tests*", "img*", "docker*", "coverage*", "node_modules*"]
+
 [tool.bandit]
 # Bandit security scanning configuration
 # Exclude internal tooling directories that are not customer-facing products