specsmith 0.15.0.dev554__tar.gz → 0.15.0.dev556__tar.gz

{specsmith-0.15.0.dev554/src/specsmith.egg-info → specsmith-0.15.0.dev556}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.15.0.dev554
+Version: 0.15.0.dev556
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -915,6 +915,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Workflow:** `phase show/set/next/list` `ledger add/list` `req list/add/gaps/trace`
 
+**Work Items:** `wi list` `wi show` `wi close` `wi archive` `wi promote` `wi tag` `wi import`
+
 **Agent:** `run` `agent run/plan/status/verify/improve/reports` `agent providers/tools/skills` `agent suggest-profiles` `agent endpoint-presets`
 
 **Dispatch:** `dispatch run` `dispatch status` `dispatch list` `dispatch retry`
@@ -939,7 +941,7 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 ---
 
-## 53 Project Types
+## 64 Project Types
 
 **Python:** `cli-python`, `library-python`, `backend-frontend`, `backend-frontend-tray`, `embedded-python-hmi`, `research-python`.
 
@@ -967,6 +969,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Business / Legal / AEE:** `business-plan`, `legal-compliance`, `monorepo`, `browser-extension`, `epistemic-pipeline`, `knowledge-engineering`, `aee-research`.
 
+**Declarative / Formal:** `brief-lang` (Brief v0.14.0 — contract-enforced logic language, `.bv`/`.sbv`/`.ebv`/`.rbv`).
+
 ---
 
 ## epistemic Library

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/README.md

@@ -837,6 +837,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Workflow:** `phase show/set/next/list` `ledger add/list` `req list/add/gaps/trace`
 
+**Work Items:** `wi list` `wi show` `wi close` `wi archive` `wi promote` `wi tag` `wi import`
+
 **Agent:** `run` `agent run/plan/status/verify/improve/reports` `agent providers/tools/skills` `agent suggest-profiles` `agent endpoint-presets`
 
 **Dispatch:** `dispatch run` `dispatch status` `dispatch list` `dispatch retry`
@@ -861,7 +863,7 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 ---
 
-## 53 Project Types
+## 64 Project Types
 
 **Python:** `cli-python`, `library-python`, `backend-frontend`, `backend-frontend-tray`, `embedded-python-hmi`, `research-python`.
 
@@ -889,6 +891,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Business / Legal / AEE:** `business-plan`, `legal-compliance`, `monorepo`, `browser-extension`, `epistemic-pipeline`, `knowledge-engineering`, `aee-research`.
 
+**Declarative / Formal:** `brief-lang` (Brief v0.14.0 — contract-enforced logic language, `.bv`/`.sbv`/`.ebv`/`.rbv`).
+
 ---
 
 ## epistemic Library

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.15.0.dev554"
+version = "0.15.0.dev556"
 description = "AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider."
 readme = "README.md"
 license = "MIT"

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/config.py

@@ -96,6 +96,10 @@ class ProjectType(str, Enum):
     # Desktop
     DESKTOP_ELECTRON = "desktop-electron"  # Electron desktop app
     DESKTOP_TAURI = "desktop-tauri"  # Tauri desktop app (Rust + WebView)
+    # Brief lang — declarative contract-enforced logic language (github.com/Randozart/brief-lang)
+    # Version anchor: v0.14.0 @ commit 6a43c4aebcc5c6c774dbc2908445fb19486e8043 (2026-06-14)
+    # No release tags exist yet; version string + commit hash are both recorded.
+    BRIEF_LANG = "brief-lang"  # .bv/.sbv/.rbv/.ebv project using brief-compiler
 
 
 class Platform(str, Enum):
@@ -604,6 +608,8 @@ _TYPE_LABELS: dict[str, str] = {
     # Desktop
     ProjectType.DESKTOP_ELECTRON: "Desktop application (Electron)",
     ProjectType.DESKTOP_TAURI: "Desktop application (Tauri — Rust + WebView)",
+    # Brief lang
+    ProjectType.BRIEF_LANG: "Brief lang — declarative contract-enforced logic language (v0.14.0)",
 }
 
 _SECTION_REFS: dict[str, str] = {
@@ -662,4 +668,6 @@ _SECTION_REFS: dict[str, str] = {
     # Desktop
     ProjectType.DESKTOP_ELECTRON: "17.48",
     ProjectType.DESKTOP_TAURI: "17.49",
+    # Brief lang
+    ProjectType.BRIEF_LANG: "17.50",
 }

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/importer.py

@@ -1100,6 +1100,12 @@ def _infer_type(result: DetectionResult) -> ProjectType:
     lang = result.primary_language
     build = result.build_system
 
+    # Brief lang — .bv/.sbv/.rbv/.ebv files are unambiguous; check before Rust
+    # (the brief-lang compiler repo is Rust + .bv files; .bv files are the signal)
+    # Version anchor: v0.14.0 @ 6a43c4ae (github.com/Randozart/brief-lang)
+    if lang == "brief":
+        return ProjectType.BRIEF_LANG
+
     # Hardware types
     if lang in ("vhdl", "verilog", "systemverilog"):
         return ProjectType.FPGA_RTL

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/languages.py

@@ -131,6 +131,15 @@ EXT_LANG: dict[str, str] = {
     ".kicad_sch": "kicad",
     ".kicad_pro": "kicad",
     ".sch": "kicad",  # legacy KiCad schematic
+    # Brief lang (github.com/Randozart/brief-lang v0.14.0 @ 6a43c4ae)
+    # All variants map to the same language key; strictness is a compiler flag, not a language.
+    ".bv": "brief",  # Brief — declarative contract logic (normal mode)
+    ".sbv": "brief",  # Strict Brief — hard errors on incomplete contracts
+    ".rbv": "brief",  # Rendered Brief — Brief + web UI (HTML/CSS/SVG → WASM)
+    ".ebv": "brief",  # Embedded Brief — Brief + hardware triggers (FPGA/ARM)
+    ".dbv": "brief",  # Data Brief — configuration data
+    ".dbvs": "brief",  # Data Brief Schema — FFI bindings / target specs
+    ".dbvl": "brief",  # Data Brief Lines — line-based databases
     # Data science
     ".r": "r",
     ".rmd": "r",
@@ -197,6 +206,7 @@ LANG_DISPLAY: dict[str, str] = {
     "latex": "LaTeX",
     "bibtex": "BibTeX",
     "asciidoc": "AsciiDoc",
+    "brief": "Brief",
     "kicad": "KiCad",
     "r": "R",
     "julia": "Julia",
@@ -264,6 +274,7 @@ LANG_CATEGORY: dict[str, str] = {
     "latex": "Documentation",
     "bibtex": "Documentation",
     "asciidoc": "Documentation",
+    "brief": "Declarative / Formal",
     "kicad": "Hardware / EDA",
     "r": "Data Science",
     "julia": "Data Science",

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/scaffolder.py

@@ -284,6 +284,17 @@ def _get_empty_dirs(config: ProjectConfig, target: Path) -> list[Path]:
         )
     elif config.type in (ProjectType.CLI_RUST, ProjectType.LIBRARY_RUST):
         dirs.extend([target / "src", target / "tests", target / "benches"])
+    elif config.type == ProjectType.BRIEF_LANG:
+        # Brief lang project: .bv sources, library modules, contract tests
+        # brief-compiler check src/  — lint pass
+        # brief-compiler rust src/main.bv  — compile to Rust
+        dirs.extend(
+            [
+                target / "src",  # .bv source files
+                target / "lib",  # imported .bv library modules
+                target / "tests",  # contract test .bv files
+            ]
+        )
     elif config.type in (ProjectType.CLI_GO,):
         dirs.extend([target / "cmd", target / "internal", target / "pkg", target / "tests"])
     elif config.type in (ProjectType.CLI_C, ProjectType.LIBRARY_C):

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/skills/software_engineering.py

@@ -1188,6 +1188,236 @@ git remote prune origin
 - [ ] CI passing before requesting review
 - [ ] All review comments addressed or explained
 - [ ] Branch deleted after merge
+""",
+    ),
+    # ── Brief lang ────────────────────────────────────────────────────────────
+    SkillEntry(
+        slug="brief-lang",
+        name="Brief lang — declarative contract-enforced logic language",
+        description=(
+            "End-to-end workflow for projects using Brief (v0.14.0): file variants, "
+            "compiler commands, contract syntax (txn/rct/let/[pre][post]), "
+            "build targets (Rust/C/LLVM/WASM/VHDL/COBOL), and governance rules."
+        ),
+        domain=SkillDomain.SOFTWARE_ENGINEERING,
+        tags=[
+            "brief",
+            "brief-lang",
+            "declarative",
+            "contracts",
+            "transactions",
+            "state-machine",
+            "llvm",
+            "wasm",
+            "fpga",
+            "cobol",
+            "formal-verification",
+            "rust",
+        ],
+        project_types=["brief-lang"],
+        platforms=["windows", "linux", "macos"],
+        prerequisites=["brief-compiler", "cargo"],
+        body="""\
+# Brief lang
+
+**Version anchor: v0.14.0 — commit `6a43c4aebcc5c6c774dbc2908445fb19486e8043` (2026-06-14)**
+No release tags exist yet. Both the declared version and the commit hash are kept for
+reproducibility. Update this file when Brief ships a tagged release.
+
+Source: https://github.com/Randozart/brief-lang
+
+## What is Brief?
+
+Brief is a declarative, contract-enforced logic language for verifiable state machines.
+Programs are a set of *transactions* whose preconditions and postconditions the compiler
+proves. Execution is inferred: a reactor loop fires transactions automatically when their
+preconditions are met. Brief transpiles to many imperative backends — Rust, C, LLVM IR,
+COBOL, SystemVerilog, VHDL, and browser WASM.
+
+## File variants
+
+| Extension | Variant | Targets |
+|-----------|---------|--------|
+| `.bv` | Brief (normal) | LLVM → binary, COBOL |
+| `.sbv` | Strict Brief | Same — hard errors on incomplete contracts |
+| `.rbv` | Rendered Brief | Browser: WASM + JS + HTML + CSS + SVG |
+| `.ebv` | Embedded Brief | FPGA (VHDL/SystemVerilog), ARM bare-metal |
+| `.dbv` | Data Brief | Configuration data (all targets) |
+| `.dbvs` | Data Brief Schema | FFI bindings / target specs |
+| `.dbvl` | Data Brief Lines | Line-based databases |
+
+Prefer `.sbv` for production code — the proof engine enforces complete contracts.
+
+## Build the compiler (required — no pre-built binaries at v0.14.0)
+
+```bash
+git clone https://github.com/Randozart/brief-lang.git
+cd brief-lang
+git checkout 6a43c4aebcc5c6c774dbc2908445fb19486e8043   # pin to v0.14.0
+cargo build --release
+# Compiler is now at ./target/release/brief-compiler
+export PATH="$PWD/target/release:$PATH"
+```
+
+## Compiler commands (v0.14.0)
+
+```bash
+# Type-check only (fast — use in CI lint step)
+brief-compiler check counter.bv
+
+# Strict mode — proof engine, hard errors (use in CI typecheck step)
+brief-compiler check --strict counter.sbv
+brief-compiler check --strict counter.bv   # force strict on .bv file
+
+# Compile to backend
+brief-compiler rust  counter.bv            # → Rust source
+brief-compiler c     counter.bv            # → C source
+brief-compiler llvm  counter.bv            # → LLVM IR (.ll)
+brief-compiler compile counter.bv --target aarch64.dbvs   # → AArch64 asm
+brief-compiler compile counter.bv --target x86_64.dbvs    # → x86-64 asm
+
+# Hardware targets
+brief-compiler compile counter.ebv --target vhdl.dbvs       # → VHDL
+brief-compiler compile counter.ebv --target systemverilog.dbvs  # → SV
+
+# Web target
+brief-compiler compile app.rbv --target wasm.dbvs           # → WASM + JS glue
+
+# FFI bindings from a C header
+brief-compiler bind mylib.h                # generates mylib.dbvs
+
+# Metropolitan shared-memory service
+brief-compiler metrod connect WeatherApi   # bind to a running service
+
+# LSP server (for editor integration)
+brief-compiler lsp
+
+# Run compiler-internal tests (requires Cargo.toml)
+cargo test --lib
+```
+
+## Language syntax
+
+### Variables
+```brief
+let counter: Int = 0;
+let name: String = "Alice";
+```
+
+### Transactions — the core unit
+```brief
+txn increment() [counter < 100][counter == @counter + 1] {
+    &counter = counter + 1;   // &var = mutation
+    term;                      // required terminator
+};
+
+// @counter = "counter before this transaction"
+// [pre][post] = precondition and postcondition contracts
+```
+
+### Reactive transactions — fire automatically
+```brief
+rct txn auto_save() [dirty && !saving][!dirty] {
+    save_to_disk();
+    &dirty = false;
+    term;
+};
+// Fires whenever dirty==true and saving==false — no polling, no event handlers
+```
+
+### Guards (replaces if/else)
+```brief
+[x > 0] { &result = x * 2; };
+[x < 0] { &result = x * -1; };
+[x == 0] { escape; };   // escape = rollback this transaction
+```
+
+### Entry point
+```brief
+txn main() [true][true] {
+    increment();
+    increment();
+    term;
+};
+```
+
+### Contract patterns
+```brief
+// Withdraw with full pre+post contract
+txn withdraw(amount: Int)
+    [amount > 0 && balance >= amount]   // precondition
+    [balance == @balance - amount]       // postcondition
+{
+    &balance = balance - amount;
+    term;
+};
+
+// Partial contract — compiles with warnings (.bv)
+txn log_event(msg: String) [true][] {
+    write_log(msg);
+    term;
+};
+```
+
+### FFI (Metropolitan interface)
+```brief
+// Declare an external function via .dbvs binding
+use std::io::PrintLine;   // from std/bindings/io.dbvs
+
+txn greet(name: String) [true][true] {
+    PrintLine(name);
+    term;
+};
+```
+
+## Project layout (specsmith scaffold)
+
+```
+src/        — .bv / .sbv primary source files
+lib/        — .bv library modules (imported by src/)
+tests/      — contract test .bv files
+target/     — build output (gitignored)
+```
+
+## CI workflow (GitHub Actions)
+
+```yaml
+steps:
+  - uses: dtolnay/rust-toolchain@stable
+  - name: Build brief-compiler (v0.14.0 @ 6a43c4ae)
+    run: |
+      git clone https://github.com/Randozart/brief-lang.git brief-lang
+      cd brief-lang && git checkout 6a43c4aebcc5c6c774dbc2908445fb19486e8043
+      cargo build --release
+      echo "$PWD/brief-lang/target/release" >> $GITHUB_PATH
+
+  - name: Lint (brief-compiler check)
+    run: brief-compiler check src/
+
+  - name: Typecheck (strict mode)
+    run: brief-compiler check --strict src/
+
+  - name: Build to Rust
+    run: brief-compiler rust src/main.bv
+```
+
+## Governance rules for Brief projects
+
+- Every transaction MUST declare at least a precondition or postcondition — H13.
+- `.sbv` (strict mode) is required for all production code paths.
+- Compiler output (`target/`) is a **derived artifact** — never hand-edit generated Rust/C.
+- FFI boundaries declared via `.dbvs` files are governance artifacts: treat them like API specs.
+- `escape;` (rollback) must be documented with a comment explaining the failure condition.
+- Contract completeness = proof coverage: treat incomplete contracts as audit warnings.
+
+## Common pitfalls
+
+- `term;` is required at the end of every transaction body — missing it is a parse error.
+- `@var` refers to the variable value *before* the transaction; `var` after reassignment is the new value.
+- `.bv` files compile with warnings for incomplete contracts; `.sbv` makes them errors.
+- The Metropolitan FFI is the only way to interact with foreign code — no inline foreign calls.
+- The reactor loop infers execution order; don't assume sequential call order between transactions.
+- `brief-compiler lsp` provides editor integration — configure it in your IDE before writing Brief.
 """,
     ),
     SkillEntry(

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556}/src/specsmith/tools.py

@@ -12,6 +12,14 @@ if TYPE_CHECKING:
 
 from specsmith.config import ProjectType
 
+# ---------------------------------------------------------------------------
+# Brief lang version anchor — no release tags exist; both identifiers are kept.
+# Update both when a new Brief version is adopted.
+# ---------------------------------------------------------------------------
+BRIEF_LANG_VERSION: str = "v0.14.0"
+BRIEF_LANG_COMMIT: str = "6a43c4aebcc5c6c774dbc2908445fb19486e8043"
+BRIEF_LANG_COMMIT_SHORT: str = BRIEF_LANG_COMMIT[:8]  # 6a43c4ae
+
 
 @dataclass(frozen=True)
 class ToolSet:
@@ -504,6 +512,21 @@ _TOOL_REGISTRY: dict[ProjectType, ToolSet] = {
         format=["prettier"],
         compliance=["specsmith trace verify"],
     ),
+    # --- Brief lang (v0.14.0 @ 6a43c4ae, github.com/Randozart/brief-lang) ---
+    # brief-compiler check      — type-checker + contract verifier (normal mode)
+    # brief-compiler check --strict — proof engine; hard errors on incomplete contracts
+    # cargo test --lib          — compiler-internal tests (Cargo.toml must exist)
+    # brief-compiler rust       — primary software build target
+    # brief-compiler llvm       — compile to LLVM IR
+    # brief-compiler lsp        — start LSP server for editor integration
+    ProjectType.BRIEF_LANG: ToolSet(
+        lint=["brief-compiler check"],
+        typecheck=["brief-compiler check --strict"],
+        test=["cargo test --lib"],
+        build=["brief-compiler rust", "brief-compiler llvm"],
+        security=[],
+        format=[],
+    ),
 }
 
 
@@ -615,6 +638,13 @@ LANG_CI_META: dict[str, dict[str, str]] = {
         "docker_image": "gcc:latest",
         "install": "",
     },
+    # Brief lang — compiler is built from source (Rust), no pre-built binary yet
+    "brief": {
+        "gh_setup": "      - uses: dtolnay/rust-toolchain@stable\n",
+        "docker_image": "rust:latest",
+        "install": "cargo build --release",
+        "brief_compiler": "./target/release/brief-compiler",
+    },
     "terraform": {
         "gh_setup": "      - uses: hashicorp/setup-terraform@v3\n",
         "docker_image": "hashicorp/terraform:latest",

{specsmith-0.15.0.dev554 → specsmith-0.15.0.dev556/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.15.0.dev554
+Version: 0.15.0.dev556
 Summary: AEE governance toolkit for AI-assisted development — session preflight gates, multi-agent dispatch, requirements↔test traceability, ESDB persistence, MCP server, and skills for Warp, Cursor, Claude Code, Copilot, Windsurf, and Aider.
 Author: Layer1Labs Silicon, Inc.
 License-Expression: MIT
@@ -915,6 +915,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Workflow:** `phase show/set/next/list` `ledger add/list` `req list/add/gaps/trace`
 
+**Work Items:** `wi list` `wi show` `wi close` `wi archive` `wi promote` `wi tag` `wi import`
+
 **Agent:** `run` `agent run/plan/status/verify/improve/reports` `agent providers/tools/skills` `agent suggest-profiles` `agent endpoint-presets`
 
 **Dispatch:** `dispatch run` `dispatch status` `dispatch list` `dispatch retry`
@@ -939,7 +941,7 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 ---
 
-## 53 Project Types
+## 64 Project Types
 
 **Python:** `cli-python`, `library-python`, `backend-frontend`, `backend-frontend-tray`, `embedded-python-hmi`, `research-python`.
 
@@ -967,6 +969,8 @@ Supported tools: **Synthesis:** vivado, quartus, radiant, diamond, gowin.
 
 **Business / Legal / AEE:** `business-plan`, `legal-compliance`, `monorepo`, `browser-extension`, `epistemic-pipeline`, `knowledge-engineering`, `aee-research`.
 
+**Declarative / Formal:** `brief-lang` (Brief v0.14.0 — contract-enforced logic language, `.bv`/`.sbv`/`.ebv`/`.rbv`).
+
 ---
 
 ## epistemic Library