Hardware-TCL

.cargo/config.toml

@@ -0,0 +1,2 @@
+[net]
+git-fetch-with-cli = true

.claude/settings.local.json

@@ -0,0 +1,31 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cargo check *)",
+      "Bash(cargo test *)",
+      "Bash(cargo build *)",
+      "Bash(cargo run *)",
+      "Bash(echo \"exit=$?\")",
+      "Read(//home/ry/src/tree-sitter-htcl/**)",
+      "Read(//home/ry/src/tree-sitter-htcl/bindings/**)",
+      "Bash(tree-sitter generate *)",
+      "Bash(tree-sitter parse *)",
+      "Bash(tree-sitter test *)",
+      "Read(//home/ry/src/redhawk/host/vivado/metro/ip/**)",
+      "Read(//home/ry/src/amd-htcl/**)",
+      "Bash(cargo install *)",
+      "Read(//home/ry/src/htcl/amd/vivado-cmd/**)",
+      "Read(//home/ry/src/htcl/amd/vivado-cmd/cmd/**)",
+      "Bash(vw ip *)",
+      "Read(//tmp/**)",
+      "Bash(vw check *)",
+      "Bash(grep -nA20 \"fn diagnostics\\\\|validate\\(\\\\|fn publish_diagnostics\" vw-analyzer/src/htcl_backend.rs)",
+      "Bash(awk '{sum += $4} END {print \"passed:\", sum}')",
+      "Bash(vw --help)",
+      "Bash(awk '{ ok+=$4; failed+=$6 } END { print ok \" passed, \" failed \" failed\" }')",
+      "Bash(cargo clippy *)",
+      "Bash(awk *)",
+      "Bash(/home/ry/src/vw/target/debug/vw run *)"
+    ]
+  }
+}

.github/buildomat/jobs/build-linux.sh

@@ -2,11 +2,14 @@
 #:
 #: name = "build-linux"
 #: variety = "basic"
-#: target = "ubuntu-22.04"
+#: target = "ubuntu-24.04"
 #: rust_toolchain = "stable"
 #: output_rules = [
 #:   "/work/release/*",
 #: ]
+#: access_repos = [
+#:   "oxidecomputer/ipe"
+#: ]
 #:
 #: [[publish]]
 #: series = "linux"

.github/buildomat/jobs/build.sh

@@ -2,11 +2,14 @@
 #:
 #: name = "build"
 #: variety = "basic"
-#: target = "helios-2.0"
+#: target = "helios-3.0"
 #: rust_toolchain = "stable"
 #: output_rules = [
 #:   "/work/release/*",
 #: ]
+#: access_repos = [
+#:   "oxidecomputer/ipe"
+#: ]
 #:
 #: [[publish]]
 #: series = "illumos"

.gitignore

@@ -1 +1,3 @@
 /target
+*.jou
+*.log

CLAUDE.md

@@ -92,3 +92,24 @@ project/
 ├── vw.toml
 └── vhdl_ls.toml
 ```
+
+## htcl language stack
+
+`vw-htcl` (winnow parser, AST, analysis) is the source of truth for
+htcl semantics. It feeds `vw run` (interpreter front-end driving an
+EDA backend), `vw analyzer` (LSP), and eventually `vw repl`.
+
+There is a sibling tree-sitter grammar at
+`~/src/tree-sitter-htcl` (repo:
+https://github.com/oxidecomputer/tree-sitter-htcl) used by editors
+for syntax highlighting. **Both must stay in sync.** When changing
+the htcl grammar in `vw-htcl/src/parser.rs` or `ast.rs`:
+
+- Update `~/src/tree-sitter-htcl/grammar.js` to match.
+- Update or add corpus tests in `~/src/tree-sitter-htcl/test/corpus/`.
+- Update `~/src/tree-sitter-htcl/queries/highlights.scm` if new node
+  types deserve distinct highlighting.
+- Run `tree-sitter generate && tree-sitter test` in that repo.
+
+The sync contract (vw-htcl leads, divergences are documented) is
+written up in `~/src/tree-sitter-htcl/README.md`.