v0.3.0 — augers, Phillips drives, custom angle/tooth_height/taper, child wrappers

- tq_thread: angle (custom flank angle), tooth_height (explicit depth), taper
- tq_auger / tq_auger_hole: deep coarse helical flight + negative
- Phillips drive: tq_phillips_drive, tq_phillips_tip, drive="phillips" on bolts
- child-difference wrappers: tq_tap, tq_drill, tq_counterbore, tq_countersink
- tq_relief_groove (thread runout)
- minor-radius assert now accounts for taper; _TQ_H made private earlier
- render-tests.ps1: Windows PowerShell 5.1 compatible (no ternary) + openscad.com
- examples/fast+heavy tests/README/MANUAL/REFERENCES/CHANGELOG + landing page

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: scottconverse

CHANGELOG.md

@@ -4,6 +4,37 @@
 All notable changes to tq-threads. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com); versions are git tags.
 
+## [0.3.0] — 2026-06-22
+
+Stronger-than-baseline release: adds the remaining helper categories users
+expect from a general thread library, plus more profile control — all clean-room.
+
+### Added
+- **Custom flank angle** `angle=60` on `tq_thread` (e.g. 55° Whitworth-ish, 45°);
+  thread height is derived from the angle (or set explicitly, below).
+- **Explicit `tooth_height`** override on `tq_thread` (sets the radial flight
+  depth directly instead of deriving it from the flats/angle).
+- **Tapered threads** `taper=` on `tq_thread` (total diameter reduction over the
+  length — NPT-ish tapers, auger tips, etc.).
+- **`tq_auger` / `tq_auger_hole`** — deep coarse helical flight + matching
+  negative (screw conveyor / drill / feed-screw style; generic, not a standard).
+- **Phillips (cross) drive**: `tq_phillips_drive` (cruciform cutter/tip),
+  `tq_phillips_tip` (driver bit), and `drive="phillips"` on `tq_bolt` /
+  `tq_countersunk_bolt`; helpers `tq_ph_dims`, `tq_ph_size_for`.
+- **Child-difference convenience wrappers** (ScrewHole/ClearanceHole in spirit,
+  `tq_*` naming): `tq_tap`, `tq_drill`, `tq_counterbore`, `tq_countersink`.
+- **`tq_relief_groove`** — thread-relief / runout groove cutter.
+
+### Changed
+- `tq_bolt` / `tq_countersunk_bolt` `drive` now selects `hex` | `phillips` |
+  `none` via a shared `_tq_drive_recess` selector (was hex-only).
+- The minor-radius safety assert now also accounts for `taper` (top of a tapered
+  thread) in addition to the rounded-root depth.
+- `_TQ_H` is no longer used for the flank-height calc (generalized to `angle`);
+  default `angle=60` is bit-for-bit backward compatible with v0.2.
+- Examples, fast/heavy test grids, README, MANUAL, and REFERENCES updated for
+  every new helper.
+
 ## [0.2.0] — 2026-06-22
 
 Feature-parity release: brings tq-threads to practical parity with common

MANUAL.md

@@ -77,6 +77,9 @@ default (or an oversize internal **cutter** with `internal=true`).
 | `hand` | `"right"` | `"right"` or `"left"`. |
 | `clearance` | `0.4` | **Total diametral** fit gap (mm); external shrinks `clearance/2`, internal grows `clearance/2`. |
 | `profile` | `"flat"` | `"flat"` (ISO/UN basic), `"sharp"` (full V), `"rounded"` (filleted root/crest). |
+| `angle` | `60` | Included flank angle (degrees). 60 = ISO/UN; e.g. 55 ≈ Whitworth. Thread height derives from it. |
+| `tooth_height` | `undef` | Explicit radial flight depth (mm). Overrides the angle-derived height. |
+| `taper` | `0` | Total **diameter** reduction over the length (mm), applied linearly (base full, top reduced) — NPT-ish tapers / auger tips. |
 | `crest_flat` | `pitch/8` | Axial crest-flat width (mm) for `flat`. |
 | `root_flat` | `pitch/4` | Axial root-flat width (mm) for `flat`. |
 | `round` | `1` | Fillet scale for `profile="rounded"` (1 = standard ISO radii). |
@@ -214,6 +217,57 @@ tq_washer(8);                                                  // ISO 7089 M8
 
 ---
 
+## Augers, drives, child wrappers & relief (v0.3)
+
+### Custom profile controls
+```openscad
+tq_thread(12, 2, 14, angle=55);            // 55° flank (Whitworth-ish)
+tq_thread(10, 2, 14, tooth_height=1.2);    // set the radial flight depth directly
+tq_thread(12, 1.75, 16, taper=3);          // cone: 3 mm dia reduction over the length
+```
+`angle` (default 60) sets the included flank angle; the thread height derives
+from it. `tooth_height` overrides that height explicitly. `taper` shifts the
+whole profile inward linearly along Z (NPT-ish tapers, auger tips). The
+minor-radius safety assert accounts for both rounded roots and `taper`.
+
+### Auger / deep coarse flight
+```openscad
+tq_auger(d, length, pitch=d, flight=0.28·d, profile="rounded", starts=1, taper=0);
+tq_auger_hole(d, length, pitch, flight, through=true);   // negative for a channel
+```
+A generic deep, large-pitch helical flight (screw-conveyor / drill / feed-screw
+style) — `tq_thread` driven with a big pitch + explicit `tooth_height`. Not a
+specific auger standard.
+
+### Phillips (cross) drive
+```openscad
+tq_bolt(6, 1.0, 14, drive="phillips");           // bolt with a Phillips recess
+tq_countersunk_bolt(6, 1.0, 14, drive="phillips");
+tq_phillips_drive(size=2, depth);                // cruciform cutter / tip shape
+tq_phillips_tip(size=2, shank_d, length);        // driver-bit
+```
+`drive` selects the head recess: `"hex"` (default), `"phillips"`, or `"none"`.
+The Phillips form is a clean-room printable approximation (see REFERENCES),
+sized by PH number; `tq_ph_size_for(d)` maps a diameter to a PH number.
+
+### Child-difference convenience wrappers
+Apply to `children()`; each cuts its hole at position `at` (default origin, axis +Z):
+```openscad
+tq_tap(8, 1.25, 12)            cube([20,20,12]);              // threaded hole
+tq_drill(5, 8, at=[6,6,0])     cube([20,20,8]);               // clearance hole
+tq_counterbore(5, 12)          translate([-9,-9,0]) cube([18,18,12]);
+tq_countersink(5, 8)           translate([-9,-9,0]) cube([18,18,8]);
+```
+These are the ScrewHole/ClearanceHole idea expressed as original `tq_*` modules.
+
+### Thread-relief groove
+```openscad
+difference() { tq_thread(10,1.5,16); translate([0,0,5]) tq_relief_groove(10); }
+```
+A shallow runout groove so a mating nut can seat fully.
+
+---
+
 ## Hardware dimension tables
 
 Public lookup **functions** (return nominal ISO values; ratio fallback for

README.md

@@ -8,7 +8,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
 [![GPL‑2.0 compatible](https://img.shields.io/badge/GPL--2.0-compatible-blue.svg)](#license--attribution)
 [![OpenSCAD](https://img.shields.io/badge/OpenSCAD-2021.01%2B-f9d72c.svg)](https://openscad.org)
-[![Version](https://img.shields.io/badge/version-0.2.0-informational.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.3.0-informational.svg)](CHANGELOG.md)
 [![CI](https://github.com/scottconverse/tq-threads/actions/workflows/ci.yml/badge.svg)](https://github.com/scottconverse/tq-threads/actions/workflows/ci.yml)
 
 *Threaded rods, bolts, nuts, tapped holes, countersinks, washers, standoffs, couplers and caps — every thread is a single watertight `polyhedron`, so models stay manifold and export straight to STL.*
@@ -148,10 +148,17 @@ with anything. Common combinations (full recipes in **[MANUAL.md](MANUAL.md#inte
 | Lead‑in/out chamfers | `lead_in`, `lead_out`, `chamfer` |
 | FDM clearance + over/undersize | `clearance=`, `internal=` |
 | Flat / sharp / rounded profile | `profile=`, `crest_flat`, `root_flat`, `round` |
+| **Custom flank angle** | `angle=` (default 60°) |
+| **Explicit tooth height** | `tooth_height=` |
+| **Tapered threads** (NPT‑ish, auger tips) | `taper=` |
 | Partial arc | `arc=<deg>` |
 | Rod / bolt / countersunk bolt / wood screw | `tq_threaded_rod`, `tq_bolt`, `tq_countersunk_bolt`, `tq_wood_screw` |
+| **Hex *or* Phillips drive** | `drive="hex"\|"phillips"\|"none"`; `tq_phillips_drive`, `tq_phillips_tip` |
+| **Auger / deep coarse flight** | `tq_auger`, `tq_auger_hole` |
 | Nut / standoff / coupler | `tq_nut`, `tq_standoff`, `tq_rod_coupler` |
 | Tapped / clearance / counterbore / countersink holes | `tq_threaded_hole`, `tq_clearance_hole`, `tq_recessed_clearance_hole`, `tq_countersunk_clearance_hole` |
+| **Child‑difference wrappers** | `tq_tap`, `tq_drill`, `tq_counterbore`, `tq_countersink` |
+| **Thread‑relief groove** | `tq_relief_groove` |
 | Washer | `tq_washer` |
 | Hex / drive geometry | `tq_hex`, `tq_hex_drive`, `tq_hex_across_flats/corners`, `tq_hex_key_af` |
 | Bottle / coarse thread | `tq_bottle_thread` |
@@ -220,10 +227,11 @@ Reach for **brass heat‑set inserts** instead of a printed thread when the hole
 Concise list; **full signatures + every parameter are in [MANUAL.md](MANUAL.md#api)**.
 
 ```openscad
-// core
+// core (v0.3 adds angle, tooth_height, taper)
 tq_thread(d, pitch, length, internal=false, starts=1, hand="right",
-          clearance=0.4, profile="flat", crest_flat, root_flat, round=1,
-          lead_in=true, lead_out=true, chamfer, arc=360, fn, steps_per_pitch=16, center=false);
+          clearance=0.4, profile="flat", angle=60, tooth_height, crest_flat, root_flat,
+          round=1, lead_in=true, lead_out=true, chamfer, taper=0,
+          arc=360, fn, steps_per_pitch=16, center=false);
 
 // presets / specs
 tq_preset(name) -> [major, pitch];   tq_thread_preset(name, length, ...);
@@ -234,11 +242,22 @@ tq_threaded_rod(d,pitch,length,...);  tq_thread_cutter(d,pitch,length,through=tr
 tq_threaded_hole(d,pitch,depth,through=true,...);  tq_standoff(d,pitch,length,od,...);
 tq_nut(d,pitch,height,across_flats,chamfer=true,...);
 
-// bolts / screws (solid, fused)
+// bolts / screws (solid, fused) — drive = "hex" | "phillips" | "none"
 tq_bolt(d,pitch,length,head="socket"|"hex"|"plain"|"none",shank=0,drive="hex",...);
-tq_countersunk_bolt(d,pitch,length,head_d,head_angle=90,shank=0,...);
+tq_countersunk_bolt(d,pitch,length,head_d,head_angle=90,shank=0,drive="hex",...);
 tq_wood_screw(d,length,pitch,head="countersunk"|"pan",point=true,...);
 
+// drives, auger, relief (v0.3)
+tq_phillips_drive(size,depth);  tq_phillips_tip(size,shank_d,length);
+tq_auger(d,length,pitch,flight,taper=0,...);  tq_auger_hole(d,length,pitch,flight,through=true,...);
+tq_relief_groove(d,width,depth);
+
+// child-difference convenience wrappers (v0.3): cut a hole into children() at `at`
+tq_tap(d,pitch,depth,at=[0,0,0],...) <children>;
+tq_drill(size,depth,at=[0,0,0],fit="medium",...) <children>;
+tq_counterbore(size,depth,at=[0,0,0],...) <children>;
+tq_countersink(size,depth,at=[0,0,0],angle=90,...) <children>;
+
 // holes / washers / rods
 tq_clearance_hole(size,depth,fit="medium",through=true,...);
 tq_recessed_clearance_hole(size,depth,head_d,head_h,...);     // counterbore

REFERENCES.md

@@ -94,6 +94,38 @@ for sizes outside its table.
 > formulae** only. Values were transcribed/derived from the published series;
 > no third-party library's data tables, code, or parameter choices were used.
 
+### v0.3 additions — profile controls, drives, auger, taper
+
+- **Custom flank angle** (`angle`, default 60°). The sharp-V height for a
+  symmetric included angle α follows from the right triangle of half-angle α/2
+  over an axial half-pitch: `H = (P/2)/tan(α/2)`, and the flank radial height is
+  `h = (P − crest_flat − root_flat)/(2·tan(α/2))`. For α=60° this reduces to the
+  ISO/UN `h = (P−cf−rf)·(√3/2)` used in v0.2 (bit-for-bit compatible). This is
+  pure trigonometry, not taken from any library. Non-60° angles are useful for
+  Whitworth-style (55°) or shallow printable threads.
+- **Explicit tooth height** (`tooth_height`). A direct override of the radial
+  flight depth `h`; geometry then interpolates the flanks between the flats and
+  the given depth. No external source — it is just exposing `h` as an input.
+- **Tapered threads** (`taper`). The whole profile is shifted radially inward by
+  `(taper/2)·(z/L)` along the length — a linear cone applied to the height-field.
+  For reference, real tapered pipe threads (e.g. **ANSI/ASME B1.20.1 NPT**) use a
+  1:16 taper (≈1.79° per side); `taper` lets you reproduce any linear taper, but
+  this library does not implement NPT's specific truncated profile.
+- **Phillips (cross) recess** (`tq_phillips_drive`, `drive="phillips"`). The
+  cruciform recess concept (a central point plus four 90°-spaced wings that taper
+  toward the tip) is described by **ISO 4757** (cross recesses for screws) and
+  the ANSI Type I Phillips standard. tq-threads builds an **approximate, clean-room**
+  cruciform from OpenSCAD primitives (a tapered core + two crossed hulled wings)
+  sized by PH number; it is a printable approximation, not a gauge-accurate
+  Phillips form, and no third-party recess code was used.
+- **Auger / deep coarse flight** (`tq_auger`). A generic deep, large-pitch single
+  /multi-start helical flight (screw-conveyor / drill / feed-screw style). No
+  specific standard; it is the core `tq_thread` driven with a large pitch and an
+  explicit `tooth_height`, optionally tapered.
+- **Child-difference wrappers** (`tq_tap`, `tq_drill`, `tq_counterbore`,
+  `tq_countersink`) and `tq_relief_groove` are pure OpenSCAD `difference()`
+  conveniences over the existing primitives — original code, `tq_*` named.
+
 The coarse "bottle/jar" thread (`tq_bottle_thread`) is a **generic** printable
 rounded coarse thread, **not** a specific consumer-packaging finish. If you need
 a real finish, public references include the **SPI/GPI "400-series"** finish

docs/index.html

@@ -71,12 +71,12 @@ <h1>tq-threads</h1>
       <a href="https://github.com/scottconverse/tq-threads/blob/main/LICENSE"><img alt="MIT" src="https://img.shields.io/badge/License-MIT-green.svg"></a>
       <img alt="GPL-2.0 compatible" src="https://img.shields.io/badge/GPL--2.0-compatible-blue.svg">
       <img alt="OpenSCAD" src="https://img.shields.io/badge/OpenSCAD-2021.01%2B-f9d72c.svg">
-      <img alt="version" src="https://img.shields.io/badge/version-0.2.0-informational.svg">
+      <img alt="version" src="https://img.shields.io/badge/version-0.3.0-informational.svg">
       <a href="https://github.com/scottconverse/tq-threads/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/scottconverse/tq-threads/actions/workflows/ci.yml/badge.svg"></a>
     </div>
     <div class="cta">
       <a class="btn primary" href="https://github.com/scottconverse/tq-threads">View on GitHub</a>
-      <a class="btn ghost" href="https://github.com/scottconverse/tq-threads/releases/tag/v0.2.0">Download v0.2.0</a>
+      <a class="btn ghost" href="https://github.com/scottconverse/tq-threads/releases/tag/v0.3.0">Download v0.3.0</a>
       <a class="btn ghost" href="https://github.com/scottconverse/tq-threads/blob/main/MANUAL.md">Manual</a>
       <a class="btn ghost" href="https://github.com/scottconverse/tq-threads/discussions">Discussions</a>
     </div>
@@ -90,7 +90,7 @@ <h2>Why tq-threads</h2>
       <div class="card"><h3>🧩 Manifold by construction</h3><p>The thread surface is a helical height-field turned into one closed <code>polyhedron</code> — no boolean unions to go non-manifold. It renders cleanly and slices.</p></div>
       <div class="card"><h3>📐 Standards-based, clean-room</h3><p>Built only from public standards (ISO 68-1/261/262/273/4032/4762/7089/10642, ASME&nbsp;B1.1). No third-party thread library was copied or consulted.</p></div>
       <div class="card"><h3>🖨️ Printable-first</h3><p>Fit clearance, internal-oversize / external-undersize compensation, lead-in chamfers, rounded roots, and real <code>$fn/$fa/$fs</code> are all parameters.</p></div>
-      <div class="card"><h3>🔩 Batteries included</h3><p>Presets <strong>M2–M64</strong> + fine + UNC/UNF, plus bolts, nuts, washers, countersunk &amp; wood screws, clearance/counterbore/countersink holes, standoffs, couplers.</p></div>
+      <div class="card"><h3>🔩 Batteries included</h3><p>Presets <strong>M2–M64</strong> + fine + UNC/UNF, plus bolts, nuts, washers, countersunk &amp; wood screws, clearance/counterbore/countersink holes, standoffs, couplers — and v0.3 adds <strong>augers, Phillips drives, tapered &amp; custom‑angle threads,</strong> and child‑difference <code>tq_tap</code>/<code>tq_drill</code> wrappers.</p></div>
       <div class="card"><h3>⚖️ MIT licensed</h3><p>Permissive <em>and</em> GPL-2.0-compatible, so it drops into a GPL-2.0-only project (e.g.&nbsp;TinkerQuarry) unchanged.</p></div>
       <div class="card"><h3>✅ Tested &amp; CI</h3><p>Compile-time preset assertions, split fast/heavy suites, a PowerShell render-proof, and GitHub Actions rendering on every push.</p></div>
     </div>

scripts/render-tests.ps1

@@ -22,6 +22,13 @@
     pwsh scripts/render-tests.ps1 -OpenSCAD "C:\Program Files\OpenSCAD\openscad.exe" -Heavy
 
 .NOTES
+    Runs on BOTH Windows PowerShell 5.1 and PowerShell 7+ (pwsh). No PS7-only
+    syntax is used.
+
+    On Windows, prefer the console build "openscad.com" (returns exit codes and
+    stderr to the console correctly); "openscad.exe" is the GUI build and may not
+    surface console output. This script auto-detects ".com" first, then ".exe".
+
     Expected render times (typical desktop):
       fast suite  (tq_threads_fast_tests.scad) :  ~2-8  seconds
       examples    (SHOW=all)                    :  ~30-90 seconds
@@ -40,10 +47,16 @@ $root = Split-Path -Parent $PSScriptRoot      # repo root (scripts/..)
 function Resolve-OpenSCAD([string]$hint) {
     $cands = @()
     if ($hint) { $cands += $hint }
+    # Prefer the Windows console build (.com) -- it returns exit codes/stderr to
+    # the console; the GUI build (.exe) may not.
     $cands += @(
+        "C:\Program Files\OpenSCAD\openscad.com",
         "C:\Program Files\OpenSCAD\openscad.exe",
+        "C:\Program Files\OpenSCAD (Nightly)\openscad.com",
         "C:\Program Files\OpenSCAD (Nightly)\openscad.exe",
+        "C:\Users\Scott\Desktop\CODE\_tools\openscad\openscad-2021.01\openscad.com",
         "C:\Users\Scott\Desktop\CODE\_tools\openscad\openscad-2021.01\openscad.exe",
+        "openscad.com",
         "openscad"
     )
     foreach ($c in $cands) {
@@ -75,7 +88,7 @@ foreach ($name in $jobs.Keys) {
                        -NoNewWindow -Wait -PassThru -RedirectStandardError $err
     $sw.Stop()
     $secs = [math]::Round($sw.Elapsed.TotalSeconds, 1)
-    $stderr = (Test-Path $err) ? (Get-Content $err -Raw) : ""
+    $stderr = if (Test-Path $err) { Get-Content $err -Raw } else { "" }   # PS 5.1-safe (no ternary)
     $warn = $stderr -match "WARNING|ERROR|not a valid 2-manifold"
     $facets = if ($stderr -match "Facets:\s*(\d+)") { $Matches[1] } else { "?" }
     $okExit = ($p.ExitCode -eq 0)