oscura 0.5.0__tar.gz → 0.5.1__tar.gz

{oscura-0.5.0 → oscura-0.5.1}/.gitignore

@@ -292,4 +292,3 @@ validation_results/
 
 # Exceptions: legitimate documentation with these keywords in name
 # (none currently - add here if needed)
-*.json

oscura-0.5.1/.vscode/extensions.json

@@ -0,0 +1,70 @@
+{
+  "recommendations": [
+    // Python
+    "ms-python.python", // Python language support
+    "ms-python.vscode-pylance", // Language server (intellisense, navigation)
+    "charliermarsh.ruff", // Linting & formatting (replaces black/flake8/isort)
+    "ms-python.mypy-type-checker", // Type checking
+
+    // Shell scripting
+    "mads-hartmann.bash-ide-vscode", // Bash language server
+    "timonwong.shellcheck", // Shell script linting
+
+    // Markdown & documentation
+    "yzhang.markdown-all-in-one", // Markdown editing & TOC
+    "davidanson.vscode-markdownlint", // Markdown linting
+    "bierner.markdown-mermaid", // Mermaid diagram preview
+    "streetsidesoftware.code-spell-checker", // Spell checking for docs
+
+    // Formatting & style
+    "esbenp.prettier-vscode", // Multi-format formatter (MD, YAML, JSON)
+    "editorconfig.editorconfig", // EditorConfig support
+
+    // Data & config files
+    "tamasfe.even-better-toml", // TOML language support
+    "redhat.vscode-yaml", // YAML language support
+    "redhat.vscode-xml", // XML language support
+    "mechatroner.rainbow-csv", // CSV/TSV visualization
+
+    // Templates
+    "samuelcolvin.jinjahtml", // Jinja2 template support
+
+    // Development utilities
+    "mhutchie.git-graph", // Lightweight git history
+    "usernamehw.errorlens", // Inline error display
+    "gruntfuggly.todo-tree", // TODO/FIXME highlighting
+    "christian-kohler.path-intellisense" // Path autocomplete
+  ],
+
+  "unwantedRecommendations": [
+    // Replaced by Ruff
+    "ms-python.black-formatter",
+    "ms-python.flake8",
+    "ms-python.isort",
+    "ms-python.autopep8",
+    "ms-python.pylint",
+    "himanoa.python-autopep8",
+    "ms-python.bandit",
+
+    // Replaced by better alternatives
+    "wholroyd.jinja", // Use samuelcolvin.jinjahtml
+    "bungcip.better-toml", // Use tamasfe.even-better-toml
+    "janisdd.vscode-edit-csv", // Use mechatroner.rainbow-csv
+    "donjayamanne.githistory", // Use mhutchie.git-graph
+
+    // Conflicts with Pylance
+    "magicstack.MagicPython",
+    "njpwerner.autodocstring",
+    "tushortz.python-extended-snippets",
+
+    // Not applicable to this project
+    "visualstudioexptteam.vscodeintellicode",
+    "eamodio.gitlens",
+    "ms-vscode.vscode-typescript-tslint-plugin",
+    "dbaeumer.vscode-eslint",
+    "ritwickdey.liveserver",
+    "yzane.markdown-pdf",
+    "shd101wyy.markdown-preview-enhanced",
+    "littlefoxteam.vscode-python-test-adapter"
+  ]
+}

oscura-0.5.1/.vscode/launch.json

@@ -0,0 +1,222 @@
+{
+  // ==========================================================================
+  // VS Code Launch Configurations for Oscura
+  // ==========================================================================
+  // Use Run > Start Debugging or F5 to launch configurations
+  //
+  // Quick Debug Tips:
+  //   - Set breakpoints by clicking left of line numbers
+  //   - F5: Start debugging
+  //   - F10: Step over
+  //   - F11: Step into
+  //   - Shift+F11: Step out
+  //   - F9: Toggle breakpoint
+  //   - Ctrl+Shift+F5: Restart
+  //   - Shift+F5: Stop
+  //
+  // Test Debugging:
+  //   - "Debug Current Test File": Debug the test file currently open
+  //   - "Debug Single Test": Debug the test under cursor
+  //   - "Debug All Tests": Debug entire test suite
+  //   - "Debug Marked Tests": Debug tests with specific marker
+  // ==========================================================================
+
+  "version": "0.2.0",
+  "configurations": [
+    // ========================================================================
+    // Test Debugging
+    // ========================================================================
+    {
+      "name": "Debug Current Test File",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["${file}", "-v", "--tb=short", "--strict-markers"],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug Single Test (under cursor)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": [
+        "${file}::${selectedText}",
+        "-v",
+        "--tb=short",
+        "--strict-markers",
+        "-s"
+      ],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug All Unit Tests",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": [
+        "tests/unit",
+        "-v",
+        "--tb=short",
+        "--strict-markers",
+        "-m",
+        "unit"
+      ],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug Integration Tests",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["tests/integration", "-v", "--tb=short", "-m", "integration"],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug Fast Tests Only",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": [
+        "tests/unit",
+        "-v",
+        "--tb=short",
+        "-m",
+        "unit and not slow and not memory_intensive"
+      ],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug Marked Tests (specify marker)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": ["tests", "-v", "--tb=short", "-m", "${input:markerName}"],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug with Coverage",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "pytest",
+      "args": [
+        "${file}",
+        "-v",
+        "--tb=short",
+        "--cov=src/oscura",
+        "--cov-report=term-missing",
+        "--cov-report=html"
+      ],
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    // ========================================================================
+    // Application Debugging
+    // ========================================================================
+    {
+      "name": "Debug Oscura CLI",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "oscura.cli.main",
+      "args": ["${input:cliCommand}"],
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    {
+      "name": "Debug Current Python File",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "justMyCode": true,
+      "env": {
+        "PYTHONPATH": "${workspaceFolder}/src"
+      }
+    },
+    // ========================================================================
+    // Validation & Script Debugging
+    // ========================================================================
+    {
+      "name": "Debug Validator (validate_all.py)",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/.claude/hooks/validate_all.py",
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "cwd": "${workspaceFolder}"
+    },
+    {
+      "name": "Debug Validator (validate_config_consistency.py)",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/.claude/hooks/validate_config_consistency.py",
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "cwd": "${workspaceFolder}"
+    },
+    {
+      "name": "Debug Validator (validate_ssot.py)",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/.claude/hooks/validate_ssot.py",
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "cwd": "${workspaceFolder}"
+    },
+    {
+      "name": "Debug Health Check",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${workspaceFolder}/.claude/hooks/health_check.py",
+      "console": "integratedTerminal",
+      "justMyCode": false,
+      "cwd": "${workspaceFolder}"
+    }
+  ],
+  // ==========================================================================
+  // Input Variables (prompted at runtime)
+  // ==========================================================================
+  "inputs": [
+    {
+      "id": "markerName",
+      "type": "promptString",
+      "description": "Enter pytest marker name (e.g., unit, slow, analyzer)",
+      "default": "unit"
+    },
+    {
+      "id": "cliCommand",
+      "type": "promptString",
+      "description": "Enter CLI command and arguments",
+      "default": "--help"
+    }
+  ]
+}