History

flemming-it 891acd2ba2 Some checks failed Security / Security check (push) Failing after 2s Details refactor: rename internal Fai* design system + fai_ helpers to chain The Studio design system, widgets and helpers carried a Fai* / fai_ prefix (FaiSpace, FaiColors, FaiTheme, FaiLog, 17 fai_.dart files, the faiBinary l10n keys). Studio is the Ch∆In product, so rename them to Chain* / chain_ — carefully preserving English fail/failure/failed. Also fix stale references: the 'fai' binary in l10n strings -> 'chain', FAI_* env vars (FAI_BIN/DATA_DIR/MODULES_DIR/TODAY/BOOTSTRAP_TOKEN) -> CHAIN_*, fai_platform -> fai_chain, fai_hub -> chain_hub. Vendor security-hook tooling (FAI_BANNED_TERMS_FILE) + the .fai bundle ext left. flutter analyze + test: clean (20 passed). Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>		2026-06-16 17:53:17 +02:00
..
accept.sh	feat(studio): daily Today-Hero proposal pipeline (v0.31.0)	2026-05-08 12:59:33 +02:00
collect.sh	refactor: rename internal Fai* design system + fai_ helpers to chain	2026-06-16 17:53:17 +02:00
prompt.template.md	refactor(brand): rename F∆I -> Ch∆In + hub binary fai -> chain	2026-06-15 16:22:22 +02:00
propose.sh	refactor: rename internal Fai* design system + fai_ helpers to chain	2026-06-16 17:53:17 +02:00
README.md	refactor: rename internal Fai* design system + fai_ helpers to chain	2026-06-16 17:53:17 +02:00

README.md

Today-Hero proposal tooling

Daily-build pipeline for the editorial Today-Hero card in Studio's store. See ../../docs/today-pipeline.md for the full design rationale.

Quick start

# 1. Generate today's proposals (calls the local Ollama by default).
./propose.sh

# 2. Skim them — they sit under ~/.fai/today/proposals/<ISO-DATE>/
ls ~/.fai/today/proposals/

# 3. Accept one. The chosen file becomes ~/.fai/today/active.yaml,
#    which Studio reads at startup.
./accept.sh ~/.fai/today/proposals/2026-05-08/candidate-2.yaml

# 4. Restart Studio (or let the next launch pick it up).

Schedule it

macOS — launchd

# Drop a plist that runs propose.sh every morning at 07:30 local time.
# `launchctl load ~/Library/LaunchAgents/ai.flemming.chain.today.plist` to
# install. The plist must point at the absolute path of propose.sh.

A starter plist lives at launchd/ai.flemming.chain.today.plist.

Linux — systemd timer

# Copy systemd/fai-today.{service,timer} into ~/.config/systemd/user/,
# then `systemctl --user enable --now fai-today.timer`.

Anywhere — cron

30 7 * * * /Users/flemming/.../tools/today/propose.sh > /tmp/fai-today.log 2>&1

Provider override

propose.sh defaults to Ollama at http://127.0.0.1:11434 with the model gemma3:4b. Override via env vars:

Variable	Default	Example
`CHAIN_TODAY_API`	`http://127.0.0.1:11434/api/generate`	`https://api.openai.com/v1/chat/completions`
`CHAIN_TODAY_MODEL`	`gemma3:4b`	`gpt-4o-mini`
`CHAIN_TODAY_KEY`	(unset)	`$OPENAI_API_KEY`
`CHAIN_TODAY_N`	`3`	`1` (single shot)

OpenAI-compatible endpoints will work as long as they speak chat/completions or generate; the script auto-detects from the URL path.

Trust model

Reads only git log, git diff, and the bundled seed.yaml of installed Ch∆In monorepos. Never your audit log without explicit op-in.
Calls only the System-AI you've already configured for Studio. The same privacy mode you set there applies here.
Writes only into ~/.fai/today/. Nothing in ~/.fai/data/ or ~/.fai/config.yaml is touched.
Studio loads active.yaml at startup; if the file is missing or fails schema validation, the compiled-in fallback story renders. KRITIS fresh installs see the fallback until and unless an operator accepts a proposal.