fkst-packages/docs/user/host-profile.env.example at dev · ChronoAIProject/fkst-packages · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# Copy to ${XDG_CONFIG_HOME:-$HOME/.config}/fkst/host.env and edit for this machine.
# This file is a host-local shell environment scaffold. Do not commit the filled copy.

# Shared fkst-framework binary built from fkst-substrate.
BIN=/path/to/fkst-substrate/target/debug/fkst-framework

# The host repository being checked or tested and the fkst-packages checkout that
# supplies the shared runner plus platform packages.
FKST_HOST_ROOT=/path/to/host-repo
FKST_PLATFORM_ROOT=/path/to/fkst-packages

# GitHub posture and repository identity. FKST_GITHUB_WRITE=1 is the only real-write
# posture; unset or any other value is dry-run.
FKST_GITHUB_REPO=owner/repo
# FKST_GITHUB_WRITE=1
FKST_GITHUB_BOT_LOGIN=this-host-bot-login
# GitHub App hosts that cannot be issue assignees may opt into label claims.
# FKST_GITHUB_CLAIM_MODE=label
# Only one App host may opt into the exclusive bare claim label.
# FKST_GITHUB_CLAIM_LABEL_EXCLUSIVE=1
# Per-owner labels default to 32 SHA-256 hex characters; values from 1 through 32 shorten them.
# FKST_GITHUB_CLAIM_LABEL_OWNER_DIGEST_HEX_LENGTH=8
# A deployment may instead declare one verbatim suffix for its owner-bound claim label.
# FKST_GITHUB_CLAIM_LABEL_SUFFIX=macstudio-4
FKST_GITHUB_PROXY_POLL_LABEL_PREFIX=fkst-dev:

# github-devloop per-device topology.
FKST_DEVLOOP_UPSTREAM_BRANCH=dev
FKST_DEVLOOP_INTEGRATION_BRANCH=integration-this-host-bot-login
FKST_DEVLOOP_ROLLUP_MERGE=auto
# Optional initial-claim scope. Membership is re-read from GitHub immediately before claim.
# FKST_DEVLOOP_INTAKE_MILESTONE_NUMBERS=34,35
# Local gate run from the deployed repository before implementation/fix handoff. The unset
# default is scripts/run.sh test-affected; configure the repository's local CI-equivalent gate
# when that executable is absent. Multi-step logic belongs inside the target, not this value.
# export FKST_DEVLOOP_LOCAL_TEST_COMMAND='make preflight'
# Optional idempotent cache hydration run from trusted base content before Codex starts.
# The candidate path is available as FKST_DEVLOOP_CACHE_PREPARATION_WORKTREE.
# export FKST_DEVLOOP_CACHE_PREPARATION_COMMAND='make prepare-cache'

# Optional: skip local BIN freshness builds when another process manages the build.
# FKST_NO_AUTOBUILD=1