History

flemming-it 68d23ab7dd Some checks are pending Security / Security check (push) Waiting to run Details refactor: rename app fai_studio -> chain_studio Studio is the Ch∆In product's GUI, not a F∆I-vendor app. Rename the Flutter package, all package: imports, and the build identity across platforms: linux/windows CMake BINARY_NAME + project, Windows Runner.rc fields, macOS PRODUCT_NAME / bundle id (ai.flemming.chain.chainStudio) / .app + scheme BuildableName. Update the client-SDK + flow-editor deps to their renamed chain_* packages (path + git URL). Company/copyright fields now read Flemming.AI. flutter analyze: clean. Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>		2026-06-16 17:48:11 +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 app fai_studio -> chain_studio	2026-06-16 17:48:11 +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	feat(studio): daily Today-Hero proposal pipeline (v0.31.0)	2026-05-08 12:59:33 +02:00
README.md	refactor: rename app fai_studio -> chain_studio	2026-06-16 17:48:11 +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
`FAI_TODAY_API`	`http://127.0.0.1:11434/api/generate`	`https://api.openai.com/v1/chat/completions`
`FAI_TODAY_MODEL`	`gemma3:4b`	`gpt-4o-mini`
`FAI_TODAY_KEY`	(unset)	`$OPENAI_API_KEY`
`FAI_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.