skill: run-sica-fondt — build/run/smoke driver for the polyglot units

Per-project run skill (run-skill-generator output). smoke.sh builds and runs the
three executable units and asserts output: Ichor (Pony) membrane reject, Ada
trust/config tests pass, COBOL E1 vault prints Invariant 0. SKILL.md documents
prerequisites (per-session toolchains + the SessionStart hook), the driver path,
per-unit commands, and the real gotchas (ponyc PATH/cwd, alr-not-gprbuild,
cobc -free). Verified: ./smoke.sh exits 0, ALL GREEN.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015hmgREHNsxYCuim33yUF2c
This commit is contained in:
Claude 2026-06-21 12:25:10 +00:00
parent 9812ee0d4b
commit 853be4ae51
No known key found for this signature in database
2 changed files with 152 additions and 0 deletions

View File

@ -0,0 +1,93 @@
---
name: run-sica-fondt
description: Build, run, launch, smoke-test, and verify the sica-fondt polyglot architecture (Pony Ichor bus, Ada/SPARK border + tests, COBOL invariant-law vault). Use when asked to run, build, compile, test, or smoke-check this project.
---
# Run sica-fondt
This repo is a **polyglot, design-first architecture**, not a single app and not
a GUI — so the harness is a **smoke driver** that builds and runs every piece
that actually executes, and checks its output. No screenshots; this is the
compiled/CLI pattern.
The three executable units (and what they prove):
- **Ichor** (`src/ichor/`, **Pony**) — the outer perfusion bus; proves the D1
membrane screens inbound traffic.
- **mafiabot_core** (`mafiabot_core/`, **Ada/SPARK** via Alire) — the border;
builds + runs `trust_tests`, `config_tests`, `engine_tests`.
- **E1 invariant-law vault** (`mafiabot_core/src/trust/invariants-architecture.cobol`,
**COBOL**) — the constitution; compiles + prints Invariants 0 / 01.
Paths below are relative to the repo root.
## Run (agent path) — the driver
```bash
.claude/skills/run-sica-fondt/smoke.sh
```
Builds + runs all three units, asserts key output, exits 0 = all green / N =
failures. Output is teed to `/tmp/{ichor,ada,cobol}.out`. This is the primary
path — start here.
## Prerequisites
Toolchains are **per-session** (the container is ephemeral). The SessionStart
hook `.claude/hooks/install-toolchains.sh` installs them automatically each
session; to do it by hand:
```bash
sudo apt-get install -y gnat gprbuild gnucobol # Ada + COBOL
sh -c "$(curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/ponylang/ponyup/latest-release/ponyup-init.sh)"
/root/.local/share/ponyup/bin/ponyup update ponyc release # Pony
curl -sSL -o /tmp/alr.zip https://github.com/alire-project/alire/releases/download/v2.1.1/alr-2.1.1-bin-x86_64-linux.zip
cd /tmp && unzip -o -q alr.zip && sudo cp bin/alr /usr/local/bin/alr # Alire
```
`ponyc` is at `/root/.local/share/ponyup/bin`; ensure it's on `PATH`.
## Build + run each unit individually
```bash
# Ichor (Pony) — MUST run from repo root
export PATH=/root/.local/share/ponyup/bin:$PATH
ponyc src/ichor -o build && ./build/ichor
# mafiabot_core (Ada) — use alr, not bare gprbuild
cd mafiabot_core && alr -n build && ./bin/trust_tests
# E1 invariant vault (COBOL) — free format required
cd mafiabot_core/src/trust
cobc -x -free -o /tmp/invariant-laws invariants-architecture.cobol && /tmp/invariant-laws
```
## Test
The Ada test executables ARE the test suite (`alr -n build` then run
`bin/trust_tests` etc.). The R/Octave organs under `src/endocrine/` have their
own `run_tests.sh` (not covered by this driver yet).
## Gotchas (battle scars from real runs)
- **`ponyc src/ichor` must run from the repo root** — from elsewhere it errors
`src/ichor: couldn't locate this path`.
- **`ponyc` may not be on PATH** even after install — it's at
`/root/.local/share/ponyup/bin`. Export it (the hook appends to `~/.bashrc`,
but a fresh non-login shell can miss it).
- **Don't run bare `gprbuild -P mafiabot_core.gpr`** — it imports
`config/mafiabot_core_config.gpr`, which **Alire generates**. Use `alr build`;
bare gprbuild fails with `imported project file ... not found`.
- **COBOL needs `-free`** — the vault is free-format; without `-free`, `cobc`
parses it as fixed-format and throws `syntax error, unexpected -` /
`invalid system-name`. The `_FORTIFY_SOURCE redefined` warning is harmless.
- **`engine_tests` prints nothing** — it's a deliberate null-stub main; success
is a clean exit, not output.
- **Ephemeral container** — toolchains vanish on restart; the SessionStart hook
reinstalls them (idempotent, non-fatal).
## Troubleshooting
| Symptom | Fix |
|---|---|
| `src/ichor: couldn't locate this path` | run `ponyc` from the repo root |
| `ponyc: command not found` | `export PATH=/root/.local/share/ponyup/bin:$PATH` |
| `imported project file "config/mafiabot_core_config.gpr" not found` | use `alr build`, not bare `gprbuild` |
| cobc `syntax error, unexpected -` / `invalid system-name` | add `-free` |

View File

@ -0,0 +1,59 @@
#!/usr/bin/env bash
# ---------------------------------------------------------------------------
# Smoke driver for sica-fondt — the run-<unit> harness.
#
# This repo is a polyglot, DESIGN-FIRST architecture, not a GUI app. The pieces
# that actually compile + execute are driven here: the Ichor outer bus (Pony),
# the mafiabot_core border + tests (Ada/Alire), and the E1 invariant-law vault
# (COBOL). No GUI -> no screenshots; this is the CLI/compiled pattern.
#
# Run: .claude/skills/run-sica-fondt/smoke.sh
# Exit: 0 = all green, non-zero = a unit failed (count of failures).
# ---------------------------------------------------------------------------
set -uo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
# Toolchains are per-session (ephemeral container); the SessionStart hook
# installs them. ponyc lands under ponyup; alr under /usr/local/bin.
export PATH="/root/.local/share/ponyup/bin:/usr/local/bin:$PATH"
fail=0
note(){ printf '\n=== %s ===\n' "$1"; }
# 1. Ichor — Pony outer bus -------------------------------------------------
note "ichor (Pony): build + run"
if command -v ponyc >/dev/null; then
( cd "$ROOT" && ponyc src/ichor -o /tmp/ichor-build >/dev/null 2>&1 \
&& /tmp/ichor-build/ichor ) | tee /tmp/ichor.out
grep -q "D1 REJECT" /tmp/ichor.out \
|| { echo "FAIL: ichor membrane reject missing"; fail=$((fail+1)); }
else
echo "SKIP: ponyc missing (install via ponyup)"; fail=$((fail+1))
fi
# 2. mafiabot_core — Ada border, build + tests ------------------------------
note "mafiabot_core (Ada): alr build + tests"
if command -v alr >/dev/null; then
( cd "$ROOT/mafiabot_core" && alr -n build >/dev/null 2>&1 \
&& for t in trust_tests config_tests engine_tests; do
[ -x "bin/$t" ] && { echo "-- $t --"; "bin/$t"; }
done ) | tee /tmp/ada.out
grep -q "ALL TRUST TESTS PASSED" /tmp/ada.out \
|| { echo "FAIL: trust tests"; fail=$((fail+1)); }
else
echo "SKIP: alr missing"; fail=$((fail+1))
fi
# 3. E1 invariant-law vault — COBOL -----------------------------------------
note "E1 invariant vault (COBOL): compile + run"
if command -v cobc >/dev/null; then
( cd "$ROOT/mafiabot_core/src/trust" \
&& cobc -x -free -o /tmp/invariant-laws invariants-architecture.cobol 2>/dev/null \
&& /tmp/invariant-laws ) | tee /tmp/cobol.out
grep -q "culpability anchor" /tmp/cobol.out \
|| { echo "FAIL: invariant vault missing Invariant 0"; fail=$((fail+1)); }
else
echo "SKIP: cobc missing"; fail=$((fail+1))
fi
note "RESULT"
if [ "$fail" = 0 ]; then echo "smoke: ALL GREEN"; else echo "smoke: FAILURES ($fail)"; fi
exit "$fail"