Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Bluefin Server — Copilot Instructions

Read [`AGENTS.md`](../AGENTS.md) for the full repo contract — build commands,
PR rules, mandatory gates, and boundaries.

## Skill routing

Use [`docs/skills/index.md`](../docs/skills/index.md) to route to the skill for your task.
3 changes: 2 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ Bluefin Server is an FSDK-based, image-based Linux server OS. It produces:

1. Read this file.
2. Load [`docs/skills/index.md`](docs/skills/index.md) to route to the skill for your task.
3. Never guess label names, workflow secrets, or infrastructure hostnames — check the relevant skill.
3. Cross-repo factory directives: follow [`projectbluefin/common:docs/factory/agentic-model.md`](https://github.com/projectbluefin/common/blob/main/docs/factory/agentic-model.md) — query `projectbluefin` MCP (`search_knowledge`) before investigating or implementing.
4. Never guess label names, workflow secrets, or infrastructure hostnames — check the relevant skill.

## Hard rules

Expand Down
21 changes: 21 additions & 0 deletions CONTEXT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# Bluefin Server

An immutable, Freedesktop-SDK-based Linux server operating system providing native systemd update and extension mechanisms.

## Language

**OS DDI**:
The immutable raw disk image payload containing the base operating system root filesystem.
_Avoid_: base image, OS rootfs, root tarball

**Installer**:
A bootable GPT raw disk image executing systemd-repart to partition and install Bluefin Server onto target media.
_Avoid_: live ISO, installation media, setup script

**Sysext**:
A systemd-sysext extension raw image merged into `/usr` to deliver decoupled server runtimes such as k0s.
_Avoid_: addon, plugin, package, sidecar

**Transfer**:
A systemd-sysupdate definition mapping a remote release asset to a local target file or partition.
_Avoid_: update manifest, download job, sync rule
2 changes: 2 additions & 0 deletions Justfile
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@ export fsdk_ref := `grep -E '^\s*ref:' elements/freedesktop-sdk.bst | head -1 |
bst *ARGS:
#!/usr/bin/env bash
set -euo pipefail
export CONTAINERS_CONF="${CONTAINERS_CONF:-/dev/null}"
export CONTAINERS_CONF_OVERRIDE="${CONTAINERS_CONF_OVERRIDE:-/dev/null}"
mkdir -p "${HOME}/.cache/buildstream"
# shellcheck disable=SC2086
{{sudo_cmd}} podman run --rm \
Expand Down
2 changes: 2 additions & 0 deletions elements/bluefin-server/linux-firmware-split.bst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ build-depends:
- freedesktop-sdk.bst:components/linux-firmware.bst

config:
integrate: False

# Exclude debug symbols, development files, and locales from composed output
exclude:
- debug
Expand Down
1 change: 1 addition & 0 deletions elements/bluefin-server/os-rootfs.bst
Original file line number Diff line number Diff line change
Expand Up @@ -9,3 +9,4 @@ config:
- debug
- devel
- doc
integrate: False
3 changes: 2 additions & 1 deletion elements/bluefin-server/os-stack.bst
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@ kind: stack
description: Stack containing all elements required to build a pure DDI Bluefin Server rootfs.

depends:
# Base runtime & core libraries
# Base runtime & core libraries (minimal non-GNU base + uutils modern userspace)
- freedesktop-sdk.bst:public-stacks/runtime-minimal.bst
- bluefin-server/uutils-coreutils.bst
- freedesktop-sdk.bst:components/ca-certificates.bst
- freedesktop-sdk.bst:components/tzdata.bst
- freedesktop-sdk.bst:integration/extra-fs.bst
Expand Down
Loading
Loading