The BQN adapter

One persistent CBQN process runs the tactic. The installed JavaScript binding owns its robot core session. Generated cy.* functions synchronously query that core over the existing pipe; geometry, lead, tracking and protocol logic remain in the core. Install with make install SDK=/opt/clunkyard/sdk after the JavaScript binding. Run with NODE_PATH=/opt/clunkyard/sdk/bindings/bqn:/opt/clunkyard/sdk/bindings/javascript /opt/clunkyard/sdk/bindings/javascript/run bot.js.

The namespace is passed to the tactic through •args; start with cy ← ⊑•args. A property call takes @, a single argument is passed directly, and multiple arguments form a list: cy.GunPowerForFlightTime range‿1. Vectors are three numbers. Other records are namespaces with camelCase fields. An absent result is @. Controls take namespaces; cy.DriveSet {throttle⇐0.5} sets only that field. Getters take a field name. All names and record shapes are generated from protocol/v2/api.json.

The familiar g cy.ShotSpeed power, g cy.Lead args, region helpers and control builders are also available. Turn returns a list of control pairs, or calls the canonical control functions and returns ⟨⟩. Controls from both paths reach the same core. Start is optional. run and play handle session failures and forfeits through the JavaScript binding. Tactic errors are logged and the turn preserves controls already set.

A tiny robot

Save this tactic as tiny.bqn:

cy ← ⊑•args
Search ← {𝕊:
  cy.DriveSet {throttle⇐0.75 ⋄ turn⇐0.25}
  cy.ScannerSet {heading⇐cy.MeHeading @ ⋄ arc⇐40}
  cy.StatusSet {text⇐"SEARCH" ⋄ value⇐(cy.ScannerLast @).arc}
}
Track ← {target←𝕩
  power←cy.GunPowerForFlightTime target.range‿1
  aim←cy.GunLead target‿power
  direction←{6=•Type 𝕩 ? 𝕩 ; {heading⇐target.bearing ⋄ pitch⇐target.elevation}} aim
  cy.GunAim {heading⇐direction.heading ⋄ pitch⇐direction.pitch}
  {cy.GunCanFire power‿10 ? cy.GunFire {power⇐power} ; @}
  cy.DriveSet {throttle⇐0.5 ⋄ turn⇐cy.AnglesClamp ⟨cy.AnglesAngleDiff target.bearing‿(cy.MeHeading @),¯1,1⟩}
  cy.ScannerSet {heading⇐target.bearing ⋄ arc⇐10}
  cy.StatusSet {text⇐"TRACK" ⋄ value⇐target.range}
}
Turn ⇐ {g 𝕊 state:
  target←cy.SensorsNearest @
  (6=•Type target)◶Search‿Track target
  ⟨⟩
}

Save the launcher as bot.js:

const {run} = require('clunkyard_bqn');
run(require('node:path').join(__dirname, 'tiny.bqn'));

make test calls the actual CBQN query and control functions against the API vectors. Complete names.

Names

Every entry of the robot API 2.0.0 in BQN. names.md has every language side by side.

Download this page as Markdown