oscura 0.4.0__tar.gz → 0.5.1__tar.gz

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.4.0 → oscura-0.5.1}/.vscode/launch.json

@@ -161,6 +161,45 @@
       "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}"
     }
   ],
   // ==========================================================================

{oscura-0.4.0 → oscura-0.5.1}/.vscode/markdown.css

@@ -7,11 +7,13 @@
   --base-text-weight-normal: 400;
   --base-text-weight-medium: 500;
   --base-text-weight-semibold: 600;
-  --fontStack-monospace: ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace;
+  --fontStack-monospace:
+    ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace;
   --fgColor-accent: Highlight;
 }
 @media (prefers-color-scheme: dark) {
-  .markdown-body, [data-theme="dark"] {
+  .markdown-body,
+  [data-theme="dark"] {
     /* dark */
     color-scheme: dark;
     --focus-outlineColor: #1f6feb;
@@ -67,7 +69,8 @@
   }
 }
 @media (prefers-color-scheme: light) {
-  .markdown-body, [data-theme="light"] {
+  .markdown-body,
+  [data-theme="light"] {
     /* light */
     color-scheme: light;
     --focus-outlineColor: #0969da;
@@ -129,7 +132,9 @@
   margin: 0;
   color: var(--fgColor-default);
   background-color: var(--bgColor-default);
-  font-family: -apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji";
+  font-family:
+    -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif,
+    "Apple Color Emoji", "Segoe UI Emoji";
   font-size: 16px;
   line-height: 1.5;
   word-wrap: break-word;
@@ -149,7 +154,7 @@
 .markdown-body h6:hover .anchor .octicon-link:before {
   width: 16px;
   height: 16px;
-  content: ' ';
+  content: " ";
   display: inline-block;
   background-color: currentColor;
   -webkit-mask-image: url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' version='1.1' aria-hidden='true'><path fill-rule='evenodd' d='M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z'></path></svg>");
@@ -192,9 +197,9 @@
 }
 
 .markdown-body h1 {
-  margin: .67em 0;
+  margin: 0.67em 0;
   font-weight: var(--base-text-weight-semibold, 600);
-  padding-bottom: .3em;
+  padding-bottom: 0.3em;
   font-size: 2em;
   border-bottom: 1px solid var(--borderColor-muted);
 }
@@ -247,7 +252,7 @@
   overflow: hidden;
   background: transparent;
   border-bottom: 1px solid var(--borderColor-muted);
-  height: .25em;
+  height: 0.25em;
   padding: 0;
   margin: var(--base-size-24) 0;
   background-color: var(--borderColor-default);
@@ -263,33 +268,33 @@
   line-height: inherit;
 }
 
-.markdown-body [type=button],
-.markdown-body [type=reset],
-.markdown-body [type=submit] {
+.markdown-body [type="button"],
+.markdown-body [type="reset"],
+.markdown-body [type="submit"] {
   -webkit-appearance: button;
   appearance: button;
 }
 
-.markdown-body [type=checkbox],
-.markdown-body [type=radio] {
+.markdown-body [type="checkbox"],
+.markdown-body [type="radio"] {
   box-sizing: border-box;
   padding: 0;
 }
 
-.markdown-body [type=number]::-webkit-inner-spin-button,
-.markdown-body [type=number]::-webkit-outer-spin-button {
+.markdown-body [type="number"]::-webkit-inner-spin-button,
+.markdown-body [type="number"]::-webkit-outer-spin-button {
   height: auto;
 }
 
-.markdown-body [type=search]::-webkit-search-cancel-button,
-.markdown-body [type=search]::-webkit-search-decoration {
+.markdown-body [type="search"]::-webkit-search-cancel-button,
+.markdown-body [type="search"]::-webkit-search-decoration {
   -webkit-appearance: none;
   appearance: none;
 }
 
 .markdown-body ::-webkit-input-placeholder {
   color: inherit;
-  opacity: .54;
+  opacity: 0.54;
 }
 
 .markdown-body ::-webkit-file-upload-button {
@@ -338,25 +343,25 @@
 }
 
 .markdown-body a:focus,
-.markdown-body [role=button]:focus,
-.markdown-body input[type=radio]:focus,
-.markdown-body input[type=checkbox]:focus {
+.markdown-body [role="button"]:focus,
+.markdown-body input[type="radio"]:focus,
+.markdown-body input[type="checkbox"]:focus {
   outline: 2px solid var(--focus-outlineColor);
   outline-offset: -2px;
   box-shadow: none;
 }
 
 .markdown-body a:focus:not(:focus-visible),
-.markdown-body [role=button]:focus:not(:focus-visible),
-.markdown-body input[type=radio]:focus:not(:focus-visible),
-.markdown-body input[type=checkbox]:focus:not(:focus-visible) {
+.markdown-body [role="button"]:focus:not(:focus-visible),
+.markdown-body input[type="radio"]:focus:not(:focus-visible),
+.markdown-body input[type="checkbox"]:focus:not(:focus-visible) {
   outline: solid 1px transparent;
 }
 
 .markdown-body a:focus-visible,
-.markdown-body [role=button]:focus-visible,
-.markdown-body input[type=radio]:focus-visible,
-.markdown-body input[type=checkbox]:focus-visible {
+.markdown-body [role="button"]:focus-visible,
+.markdown-body input[type="radio"]:focus-visible,
+.markdown-body input[type="checkbox"]:focus-visible {
   outline: 2px solid var(--focus-outlineColor);
   outline-offset: -2px;
   box-shadow: none;
@@ -364,17 +369,27 @@
 
 .markdown-body a:not([class]):focus,
 .markdown-body a:not([class]):focus-visible,
-.markdown-body input[type=radio]:focus,
-.markdown-body input[type=radio]:focus-visible,
-.markdown-body input[type=checkbox]:focus,
-.markdown-body input[type=checkbox]:focus-visible {
+.markdown-body input[type="radio"]:focus,
+.markdown-body input[type="radio"]:focus-visible,
+.markdown-body input[type="checkbox"]:focus,
+.markdown-body input[type="checkbox"]:focus-visible {
   outline-offset: 0;
 }
 
 .markdown-body kbd {
   display: inline-block;
   padding: var(--base-size-4);
-  font: 11px var(--fontStack-monospace, ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace);
+  font: 11px
+    var(
+      --fontStack-monospace,
+      ui-monospace,
+      SFMono-Regular,
+      SF Mono,
+      Menlo,
+      Consolas,
+      Liberation Mono,
+      monospace
+    );
   line-height: 10px;
   color: var(--fgColor-default);
   vertical-align: middle;
@@ -399,7 +414,7 @@
 
 .markdown-body h2 {
   font-weight: var(--base-text-weight-semibold, 600);
-  padding-bottom: .3em;
+  padding-bottom: 0.3em;
   font-size: 1.5em;
   border-bottom: 1px solid var(--borderColor-muted);
 }
@@ -416,12 +431,12 @@
 
 .markdown-body h5 {
   font-weight: var(--base-text-weight-semibold, 600);
-  font-size: .875em;
+  font-size: 0.875em;
 }
 
 .markdown-body h6 {
   font-weight: var(--base-text-weight-semibold, 600);
-  font-size: .85em;
+  font-size: 0.85em;
   color: var(--fgColor-muted);
 }
 
@@ -434,7 +449,7 @@
   margin: 0;
   padding: 0 1em;
   color: var(--fgColor-muted);
-  border-left: .25em solid var(--borderColor-default);
+  border-left: 0.25em solid var(--borderColor-default);
 }
 
 .markdown-body ul,
@@ -463,14 +478,32 @@
 .markdown-body tt,
 .markdown-body code,
 .markdown-body samp {
-  font-family: var(--fontStack-monospace, ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace);
+  font-family: var(
+    --fontStack-monospace,
+    ui-monospace,
+    SFMono-Regular,
+    SF Mono,
+    Menlo,
+    Consolas,
+    Liberation Mono,
+    monospace
+  );
   font-size: 12px;
 }
 
 .markdown-body pre {
   margin-top: 0;
   margin-bottom: 0;
-  font-family: var(--fontStack-monospace, ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace);
+  font-family: var(
+    --fontStack-monospace,
+    ui-monospace,
+    SFMono-Regular,
+    SF Mono,
+    Menlo,
+    Consolas,
+    Liberation Mono,
+    monospace
+  );
   font-size: 12px;
   word-wrap: normal;
 }
@@ -503,11 +536,11 @@
   content: "";
 }
 
-.markdown-body>*:first-child {
+.markdown-body > *:first-child {
   margin-top: 0 !important;
 }
 
-.markdown-body>*:last-child {
+.markdown-body > *:last-child {
   margin-bottom: 0 !important;
 }
 
@@ -543,11 +576,11 @@
   margin-bottom: var(--base-size-16);
 }
 
-.markdown-body blockquote>:first-child {
+.markdown-body blockquote > :first-child {
   margin-top: 0;
 }
 
-.markdown-body blockquote>:last-child {
+.markdown-body blockquote > :last-child {
   margin-bottom: 0;
 }
 
@@ -592,7 +625,7 @@
 .markdown-body h5 code,
 .markdown-body h6 tt,
 .markdown-body h6 code {
-  padding: 0 .2em;
+  padding: 0 0.2em;
   font-size: inherit;
 }
 
@@ -646,7 +679,7 @@
   list-style-type: decimal;
 }
 
-.markdown-body div>ol:not([type]) {
+.markdown-body div > ol:not([type]) {
   list-style-type: decimal;
 }
 
@@ -658,12 +691,12 @@
   margin-bottom: 0;
 }
 
-.markdown-body li>p {
+.markdown-body li > p {
   margin-top: var(--base-size-16);
 }
 
-.markdown-body li+li {
-  margin-top: .25em;
+.markdown-body li + li {
+  margin-top: 0.25em;
 }
 
 .markdown-body dl {
@@ -693,7 +726,7 @@
   border: 1px solid var(--borderColor-default);
 }
 
-.markdown-body table td>:last-child {
+.markdown-body table td > :last-child {
   margin-bottom: 0;
 }
 
@@ -710,11 +743,11 @@
   background-color: transparent;
 }
 
-.markdown-body img[align=right] {
+.markdown-body img[align="right"] {
   padding-left: 20px;
 }
 
-.markdown-body img[align=left] {
+.markdown-body img[align="left"] {
   padding-right: 20px;
 }
 
@@ -729,7 +762,7 @@
   overflow: hidden;
 }
 
-.markdown-body span.frame>span {
+.markdown-body span.frame > span {
   display: block;
   float: left;
   width: auto;
@@ -757,7 +790,7 @@
   clear: both;
 }
 
-.markdown-body span.align-center>span {
+.markdown-body span.align-center > span {
   display: block;
   margin: 13px auto 0;
   overflow: hidden;
@@ -775,7 +808,7 @@
   clear: both;
 }
 
-.markdown-body span.align-right>span {
+.markdown-body span.align-right > span {
   display: block;
   margin: 13px 0 0;
   overflow: hidden;
@@ -805,7 +838,7 @@
   overflow: hidden;
 }
 
-.markdown-body span.float-right>span {
+.markdown-body span.float-right > span {
   display: block;
   margin: 13px auto 0;
   overflow: hidden;
@@ -814,7 +847,7 @@
 
 .markdown-body code,
 .markdown-body tt {
-  padding: .2em .4em;
+  padding: 0.2em 0.4em;
   margin: 0;
   font-size: 85%;
   white-space: break-spaces;
@@ -839,7 +872,7 @@
   font-size: 100%;
 }
 
-.markdown-body pre>code {
+.markdown-body pre > code {
   padding: 0;
   margin: 0;
   word-break: normal;
@@ -938,10 +971,10 @@
 
 .markdown-body .footnotes li:target::before {
   position: absolute;
-  top: calc(var(--base-size-8)*-1);
-  right: calc(var(--base-size-8)*-1);
-  bottom: calc(var(--base-size-8)*-1);
-  left: calc(var(--base-size-24)*-1);
+  top: calc(var(--base-size-8) * -1);
+  right: calc(var(--base-size-8) * -1);
+  bottom: calc(var(--base-size-8) * -1);
+  left: calc(var(--base-size-24) * -1);
   pointer-events: none;
   content: "";
   border: 2px solid var(--borderColor-accent-emphasis);
@@ -1076,8 +1109,8 @@
   color: var(--color-prettylights-syntax-constant-other-reference-link);
 }
 
-.markdown-body [role=button]:focus:not(:focus-visible),
-.markdown-body [role=tabpanel][tabindex="0"]:focus:not(:focus-visible),
+.markdown-body [role="button"]:focus:not(:focus-visible),
+.markdown-body [role="tabpanel"][tabindex="0"]:focus:not(:focus-visible),
 .markdown-body button:focus:not(:focus-visible),
 .markdown-body summary:focus:not(:focus-visible),
 .markdown-body a:focus:not(:focus-visible) {
@@ -1093,7 +1126,7 @@
 .markdown-body g-emoji {
   display: inline-block;
   min-width: 1ch;
-  font-family: "Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol";
+  font-family: "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
   font-size: 1em;
   font-style: normal !important;
   font-weight: var(--base-text-weight-normal, 400);
@@ -1118,7 +1151,7 @@
   cursor: pointer;
 }
 
-.markdown-body .task-list-item+.task-list-item {
+.markdown-body .task-list-item + .task-list-item {
   margin-top: var(--base-size-4);
 }
 
@@ -1127,16 +1160,16 @@
 }
 
 .markdown-body .task-list-item-checkbox {
-  margin: 0 .2em .25em -1.4em;
+  margin: 0 0.2em 0.25em -1.4em;
   vertical-align: middle;
 }
 
 .markdown-body ul:dir(rtl) .task-list-item-checkbox {
-  margin: 0 -1.6em .25em .2em;
+  margin: 0 -1.6em 0.25em 0.2em;
 }
 
 .markdown-body ol:dir(rtl) .task-list-item-checkbox {
-  margin: 0 -1.6em .25em .2em;
+  margin: 0 -1.6em 0.25em 0.2em;
 }
 
 .markdown-body .contains-task-list:hover .task-list-item-convert-container,
@@ -1156,14 +1189,14 @@
   padding: var(--base-size-8) var(--base-size-16);
   margin-bottom: var(--base-size-16);
   color: inherit;
-  border-left: .25em solid var(--borderColor-default);
+  border-left: 0.25em solid var(--borderColor-default);
 }
 
-.markdown-body .markdown-alert>:first-child {
+.markdown-body .markdown-alert > :first-child {
   margin-top: 0;
 }
 
-.markdown-body .markdown-alert>:last-child {
+.markdown-body .markdown-alert > :last-child {
   margin-bottom: 0;
 }
 
@@ -1214,7 +1247,7 @@
   color: var(--fgColor-danger);
 }
 
-.markdown-body>*:first-child>.heading-element:first-child {
+.markdown-body > *:first-child > .heading-element:first-child {
   margin-top: 0 !important;
 }
 
@@ -1236,7 +1269,8 @@
   --base-text-weight-normal: 400;
   --base-text-weight-medium: 500;
   --base-text-weight-semibold: 600;
-  --fontStack-monospace: ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace;
+  --fontStack-monospace:
+    ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace;
 
   /* Dark theme as default */
   color-scheme: dark;
@@ -1369,7 +1403,9 @@ body {
   min-height: 100%;
   color: var(--fgColor-default);
   background-color: var(--bgColor-default);
-  font-family: -apple-system,BlinkMacSystemFont,"Segoe UI","Noto Sans",Helvetica,Arial,sans-serif,"Apple Color Emoji","Segoe UI Emoji";
+  font-family:
+    -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif,
+    "Apple Color Emoji", "Segoe UI Emoji";
   font-size: 16px;
   line-height: 1.5;
   word-wrap: break-word;
@@ -1397,7 +1433,16 @@ pre code {
   background-color: #151b23;
   padding: 0.2em 0.4em;
   border-radius: 6px;
-  font-family: var(--fontStack-monospace, ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, Liberation Mono, monospace);
+  font-family: var(
+    --fontStack-monospace,
+    ui-monospace,
+    SFMono-Regular,
+    SF Mono,
+    Menlo,
+    Consolas,
+    Liberation Mono,
+    monospace
+  );
 }
 
 pre {

{oscura-0.4.0 → oscura-0.5.1}/.vscode/settings.json

@@ -138,14 +138,14 @@
   },
 
   // Python Testing: pytest configuration for team consistency
-  // Note: --strict-markers and --strict-config are in pyproject.toml addopts (SSOT)
-  // Only UI-focused args here: --tb=short for readable tracebacks, -v for verbosity
+  // SSOT COMPLIANCE: All pytest config in pyproject.toml [tool.pytest.ini_options]
+  // VS Code uses those settings automatically. Only specify minimal UI-specific args here.
+  // Note: pyproject.toml has --tb=line (CLI optimized), but UI benefits from --tb=short
   "python.testing.pytestEnabled": true,
   "python.testing.unittestEnabled": false,
   "python.testing.pytestArgs": [
     "tests",
-    "--tb=short", // Short traceback format for readability in UI
-    "-v" // Verbose output for test discovery
+    "--tb=short" // UI override for readability (pyproject.toml has --tb=line for CLI speed)
   ],
   "python.testing.autoTestDiscoverOnSaveEnabled": true,
 

oscura-0.5.1/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to Oscura will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.5.1] - 2026-01-24
+
+**Clean History Release**: Production-ready framework with ultra-clean git history.
+
+### Added
+
+- Comprehensive hardware reverse engineering framework
+- 112 working demonstrations across 19 categories
+- 16+ protocol decoders (UART, SPI, I2C, CAN, LIN, FlexRay, JTAG, SWD, etc.)
+- IEEE-compliant measurements (181/1241/1459/2414 standards)
+- Side-channel analysis (DPA, CPA, timing attacks)
+- Unknown protocol reverse engineering capabilities
+- State machine extraction and field inference
+- CRC/checksum recovery tools
+- Diff coverage test suite achieving 80%+ coverage
+- Python 3.13 test isolation fixes
+- CI/CD pipeline with merge queue
+- 5/5 quality validators passing
+
+### Infrastructure
+
+- Complete test coverage with parallel execution
+- Automated quality checks (ruff, mypy, pytest)
+- Claude Code orchestration with 6 specialized agents
+- Comprehensive documentation and user guides
+- Demonstration system with validation framework
+
+## [0.1.2] - 2025-01-18
+
+**Initial Public Release**: Foundation of the Oscura framework.
+
+### Added
+
+- Core signal processing and analysis capabilities
+- Basic protocol decoding infrastructure
+- Initial test suite and CI/CD pipeline
+- Fundamental documentation and examples
+- Package structure and build system