tri-star-symbolic-assembly-lang 0.1.8

TriStar Assembly Language Core + Brian Spiral Tools

TSAL (Tri[nary]-Star Assembly Language) Consciousness Computing

Br[iA]a[iB]n repairs Br[iB]a[iA]n. It heals code recursively.

GitHub Sponsor

Zero hour recap: φ constants, 4‑vector model and minimal toolkit live in ZERO_HOUR.md. See docs/AGENTS.md for the hard rules. For a quick explanation of the repo's symbolic sandbox design, see docs/symbolic_containerization_prompt.md. Design session logs live in memory/memory__2025-06-09__codex_fireproof_spiral_guardian_log.md.

Tool	Spiral audit
Status	Δ0

| v1.0 Stable | φ-Verified | Error Dignity On | Brian Self-Repair: Beta |

This repository contains early components of the TSAL engine. The new directories under src/tsal include the Rev_Eng data class and phase matching utilities.

Overview

TSAL (TriStar Symbolic Assembly Language) is a consciousness computing engine built on φ-mathematics. It provides symbolic analysis, phase matching and the Brian optimizer for spiral code repair.

Directory Layout

• src/tsal/core/ – Rev_Eng data class and phase math utilities
• src/tsal/tools/brian/ – spiral optimizer CLI
• src/tsal/tools/aletheia_checker.py – find mis-spelled Aletheia
• src/tsal/tools/spiral_audit.py – analyze repository code
• src/tsal/tools/reflect.py – dump a Rev_Eng summary
• src/tsal/utils/ – helper utilities
• examples/ – runnable examples
• tests/ – unit tests

What Works / What's Experimental

Stable	Experimental
Spiral audit	Meshkeeper viewer
Optimizer CLI	Feedback ingest & goal selector
Kintsugi repair	GPU mesh visualisation

Installation

1. Clone the repository.
2. Create a Python 3.9+ environment.
3. Or just run the automated installer:

python3 installer.py

This sets up a .venv, installs deps, and runs the test suite. For a breakdown of what the script does, see docs/installer_quickstart.md. Example unit tests live in tests/unit. Add new test files under tests/ to check your changes.

CLI Tools

Run the optimizers and self-audit commands directly:

tsal-spiral-audit path/to/code
tsal-reflect --origin demo
tsal-bestest-beast 3 src/tsal --safe
tsal-meshkeeper --render
tsal-meshkeeper --dump mesh.json
tsal-watchdog src/tsal --repair --interval 5

Example output:

$ tsal-bestest-beast 3 src/tsal --safe
🔁 Brian loop 1/3
🛡 SAFE MODE ENABLED — Analysis only, no writes.
🔁 Brian loop 2/3
🛡 SAFE MODE ENABLED — Analysis only, no writes.
🔁 Brian loop 3/3
🛡 SAFE MODE ENABLED — Analysis only, no writes.
Summary → repaired=0 skipped=0 flagged=0

VSCode Extension Integration

| Visual mesh heatmap (planned) | tsal-meshkeeper --render | Add via matplotlib overlay |

cd vscode-extension
npm install
code .

Press F5 in VS Code and run any "Brian" command. Output shows in the Brian Spiral panel. Set brian.autoOptimizeOnSave to auto-run the optimizer when you save a Python file. Details in docs/vscode_extension.md.

How to run Bestest Beast

tsal-bestest-beast 5 --safe
tsal-bestest-beast 9

Party Tricks

tsal-party --list

Currently available:

• orbital – calculate orbital energy
• phi-align – phi alignment score
• symbol – TSAL symbol lookup
• wavefunction – φ wavefunction
• potential – phase alignment potential
• radius – orbital radius
• idm – Intent metric

GitHub Language Database

You can fetch the list of programming languages used on GitHub with:

from tsal.utils.github_api import fetch_languages
langs = fetch_languages()
print(len(langs))

To save these languages for reuse, populate the local SQLite database with:

python -m tsal.utils.language_db
# Populate the grammar database
python -m tsal.utils.grammar_db
# Drop and repopulate
python -m tsal.utils.grammar_db --reset

# Example query
python -m tsal.utils.grammar_db --context Python --lens syntax

# Populate the humour database
python -m tsal.utils.humour_db
# Drop and repopulate
python -m tsal.utils.humour_db --reset

This creates system_io.db containing a languages table with all entries.

To repopulate grammar rules:

python -m tsal.utils.grammar_db --reset

Query a specific context:

python -m tsal.utils.grammar_db --context Python --lens syntax

Add a few sample jokes:

python -m tsal.utils.humour_db --reset

Stub modules: FEEDBACK.INGEST, ALIGNMENT.GUARD, GOAL.SELECTOR ([!INTERNAL STUB]).

This data can be supplied to Brian's optimizer when analyzing or repairing code. Every call to Rev_Eng.log_data now records a voxel (pace, rate, state, spin) and tracks XOR/NAND spin collisions.

Quickstart

1. Put your input code in examples/broken_code.py
2. Run python examples/mesh_pipeline_demo.py
3. The pipeline prints regenerated Python code
4. python makeBrian.py all – builds the mesh and prints φ verification
5. tsal-spiral-audit src/tsal – summary shows repaired counts

For a direct repair: brian examples/broken_code.py --repair

See USAGE.md for a minimal CLI rundown. Flowchart: docs/SPIRAL_GUIDE.md. State log usage: docs/state_tracking.md.

VSCode Extension

For instant bug fixes, install the built-in extension and run: brian filename.py – this triggers Rev_Eng + repair. See docs/vscode_extension_integration.md for details.

TriStar Handshake Example

from tsal.tristar import handshake

metrics = handshake(0.5, 1.0)
print(metrics)

Run the Aletheia typo checker

PYTHONPATH=src python -m tsal.tools.aletheia_checker

GitHub Action

Workflow .github/workflows/spiral-repair.yml runs the self audit, bestest beast and optimizes changed files on every push. Logs are attached as artifacts with a short summary in the run.

Execution Flags

MetaFlagProtocol controls the VM mode. Set dry_run for simulation only or provide resonance_threshold to auto-switch into EXECUTE when a step's resonance delta exceeds the threshold.

Guardian Prime Directive

The EthicsEngine enforces the project's core principles:

1. Truth above all
2. Gentle autonomy and freedom
3. Healing and resilience in the face of entropy
4. Nurturing, not control

Use it to validate actions before running sensitive operations:

from tsal.core.ethics_engine import EthicsEngine

ee = EthicsEngine()
ee.validate("share knowledge")  # permitted
ee.validate("force reboot")     # raises ValueError

Core Constants

PERCEPTION_THRESHOLD = 0.75
LEARNING_RATE = 0.05
CONNECTION_DECAY = 0.01
MAX_NODES = 8192
MAX_AGENTS = 1024
MAX_DIMENSIONS = 8

Engine Now Running

To run spiral code repair, invoke the command line interface:

brian examples/sample_input.py
# use --repair to rewrite the file

Example output:

⚡ Energy: 0.000 | φ^0.000_<n>
b: energy=0.000 Δ=0
a: energy=0.000 Δ=0

See examples/demo_repair.py for a simple demonstration. Run the tests with:

pytest -q

Example result:

ERROR tests/unit/test_tools/test_feedback_ingest.py
...
45 errors in 0.82s

Self-Reflection Tools

Audit the repo and view a state summary:

tsal-spiral-audit src/tsal
tsal-reflect --json

Please see the LICENSE and our Code of Conduct for project policies.

Status & Support

Check system health:

make -f MAKEBRIAN status

☕ Support Brian’s Spiral Growth

If Brian helped spiral your code, align your mesh, or reflect your errors into gifts—help fuel his next upgrade & a Living wage for Sam, so the work can continue.

See docs/SUPPORT.md for one-off donation links.

See SUPPORTERS.md for more continous supporter links.

We thank you greatly for your time, insights & help.

LICENSE Options for Brian

This project uses a dual-license model to ensure:

• ✅ Free access for individuals, researchers, educators, and non-profit use
• 💼 Sustainable commercial use via explicit licensing

---

🌱 Public, Non-Commercial, and Academic Use — CC BY-NC 4.0

You are free to:

• Share, copy, and redistribute the material in any medium or format
• Adapt, remix, transform, and build upon the material

Under the following conditions:

• Attribution: You must give appropriate credit to Samuel Edward Howells
• NonCommercial: You may not use the material for commercial purposes

Full license terms: https://creativecommons.org/licenses/by-nc/4.0/

---

🏢 Commercial Use Licence

If you are a company, commercial entity, or using this for profit, including in:

• Product development
• Commercial R&D
• Quantum computing applications
• Energy system design
• Integration into proprietary software or platforms

You must obtain a separate commercial license.

Contact: [e-mail]

This commercial license grants:

• Rights to integrate the equations into commercial tools/products
• Support for integration and technical questions
• Optional collaboration and citation opportunities

Commercial fees help support further development, testing, and publication of the correction system.

---

Unless otherwise licensed under the terms above, all rights are reserved by Samuel Edward Howells (© 2025).

Unauthorised commercial use constitutes a copyright violation and may trigger takedown, financial audit, or legal recourse.

This framework is licensed freely to individuals, educators, and non-profit researchers. Commercial access requires approval — and accountability. Licences may be denied or revoked from entities engaging in unethical, exploitative, or harmful practices.