gitea: issue forms and a PR template, in the project's own form
Acceptance / Acceptance (pull_request) Canceled after 0s
Build / Image RASPI (push) Successful in 4m35s
Build / Image PC (push) Successful in 4m30s
Build / Image MILKV (push) Successful in 4m33s
Build / v4 tests (32- and 64-bit cells) (push) Successful in 11m7s
Acceptance / Acceptance (pull_request) Canceled after 0s
Build / Image RASPI (push) Successful in 4m35s
Build / Image PC (push) Successful in 4m30s
Build / Image MILKV (push) Successful in 4m33s
Build / v4 tests (32- and 64-bit cells) (push) Successful in 11m7s
Issues follow the record's Found / Ruled / Built / Verified
(docs/fabric/FABRIC-3.md): the reporter writes what was found and its
evidence; Captain Bob rules; the commits build it; the acceptance logs
verify it. A finding is not a request to fix it (.claude/CLAUDE.md).
.gitea/ISSUE_TEMPLATE/
1-bug.yaml Found, where, system (v4/v3), seen on (ISA, stick,
hardware), evidence (the log lines), how found
2-work.yaml what, why (the ruling or design section), done when
(with the acceptance protocol and its logs), area,
priority
3-ruling.yaml the question, the options and their costs, a
recommendation, where the ruling will be recorded,
what waits on it
4-board.yaml board, the image booted (Nexus version or commit),
what happened, the serial log, the BRINGUP.md item
config.yaml blank issues still allowed; the XWiki linked for
design and discussion
.gitea/pull_request_template.md what and why, Closes #, acceptance
(the check runs itself; hand-run logs; hardware), the
record (FABRIC-3.md, CHANGELOG), no unrequested fixes
Gitea reads these from the default branch: they apply once on master.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GE3SDvQn5EoxdGufk84zz2
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
0316573226
commit
c1bc1c8041
@@ -0,0 +1,53 @@
|
|||||||
|
name: Bug
|
||||||
|
about: Something is wrong. Report it as found -- it is fixed only when Captain Bob says so.
|
||||||
|
title: "[bug] "
|
||||||
|
labels: ["kind/bug"]
|
||||||
|
body:
|
||||||
|
- type: markdown
|
||||||
|
attributes:
|
||||||
|
value: |
|
||||||
|
Write what was **found**, with its evidence. The rest of the issue follows the project's
|
||||||
|
record (`docs/fabric/FABRIC-3.md`): **Ruled** (Captain Bob decides whether and how it is
|
||||||
|
fixed), **Built** (the commits), **Verified** (the acceptance logs). A finding is not a
|
||||||
|
request to fix it (`.claude/CLAUDE.md`, Hard Rules).
|
||||||
|
- type: textarea
|
||||||
|
id: found
|
||||||
|
attributes:
|
||||||
|
label: Found
|
||||||
|
description: What is wrong, and what happens because of it. Concrete input and the wrong output, crash or hang.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: input
|
||||||
|
id: where
|
||||||
|
attributes:
|
||||||
|
label: Where
|
||||||
|
description: File and line, or the word, capsule or board.
|
||||||
|
placeholder: "v4/src/exec.c:182"
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: dropdown
|
||||||
|
id: system
|
||||||
|
attributes:
|
||||||
|
label: System
|
||||||
|
options: ["v4 (the default)", "v3 (system=v3)", "both", "the build or CI", "not specific"]
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: dropdown
|
||||||
|
id: isa
|
||||||
|
attributes:
|
||||||
|
label: Seen on
|
||||||
|
multiple: true
|
||||||
|
options: ["amd64", "aarch64", "riscv64", "32-bit build (test-32)", "the PC stick", "hosted", "real hardware"]
|
||||||
|
- type: textarea
|
||||||
|
id: evidence
|
||||||
|
attributes:
|
||||||
|
label: Evidence
|
||||||
|
description: The serial log (`logs/<TS>/<arch>/...`), the failing test, or the steps that reproduce it. Logs are the evidence; paste the lines that matter.
|
||||||
|
render: text
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: how
|
||||||
|
attributes:
|
||||||
|
label: How it was found
|
||||||
|
description: A boot, a test, a review, real hardware.
|
||||||
@@ -0,0 +1,40 @@
|
|||||||
|
name: Work item
|
||||||
|
about: A piece of planned work -- a step of a design, or something a ruling asked for.
|
||||||
|
title: ""
|
||||||
|
labels: ["kind/feature"]
|
||||||
|
body:
|
||||||
|
- type: textarea
|
||||||
|
id: goal
|
||||||
|
attributes:
|
||||||
|
label: What
|
||||||
|
description: The work, in a sentence or two.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: why
|
||||||
|
attributes:
|
||||||
|
label: Why -- the ruling or the design it comes from
|
||||||
|
description: Captain Bob's ruling (quoted, with its date) or the document and section, e.g. `docs/v4.0.0/ENGINE.md` section 5, step 3.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: done
|
||||||
|
attributes:
|
||||||
|
label: Done when
|
||||||
|
description: What will be true, and how it is shown. Every change to the kernel or v4 is accepted by the acceptance protocol -- the three ISA boots, the PC stick loaded high, test-32 -- with its logs committed.
|
||||||
|
value: |
|
||||||
|
- [ ]
|
||||||
|
- [ ] Acceptance passes, logs in `logs/`
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: dropdown
|
||||||
|
id: area
|
||||||
|
attributes:
|
||||||
|
label: Area
|
||||||
|
multiple: true
|
||||||
|
options: ["kernel", "v4", "v3", "capsules", "proofs", "docs", "CI and build"]
|
||||||
|
- type: dropdown
|
||||||
|
id: priority
|
||||||
|
attributes:
|
||||||
|
label: Priority
|
||||||
|
options: ["must -- needed for the milestone", "should -- needed for the product", "nice to have"]
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
name: Ruling needed
|
||||||
|
about: A decision only Captain Bob can make -- an open question, a trade-off, a design choice.
|
||||||
|
title: "[ruling] "
|
||||||
|
labels: ["status/blocked"]
|
||||||
|
body:
|
||||||
|
- type: markdown
|
||||||
|
attributes:
|
||||||
|
value: |
|
||||||
|
Lay out the question so it can be ruled on. The ruling is recorded as it always is --
|
||||||
|
**Ruled (Captain Bob, date)** -- in the document it belongs to, and the issue closed with a
|
||||||
|
link to that record.
|
||||||
|
- type: textarea
|
||||||
|
id: question
|
||||||
|
attributes:
|
||||||
|
label: The question
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: options
|
||||||
|
attributes:
|
||||||
|
label: The options, and what each costs
|
||||||
|
description: Each choice with its consequences -- code size, speed, what it rules out later.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: recommendation
|
||||||
|
attributes:
|
||||||
|
label: Recommendation
|
||||||
|
description: Which option, and why. A recommendation, not a decision.
|
||||||
|
- type: input
|
||||||
|
id: record
|
||||||
|
attributes:
|
||||||
|
label: Where the ruling will be recorded
|
||||||
|
placeholder: "docs/v4.0.0/DECOMPOSITION.md section 3, D-4"
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: waits
|
||||||
|
attributes:
|
||||||
|
label: What waits on it
|
||||||
|
description: Issues or work that cannot go on until this is ruled.
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
name: Board bring-up
|
||||||
|
about: A board on real hardware -- a first boot, a failure, a step of boards/BRINGUP.md.
|
||||||
|
title: "[board] "
|
||||||
|
labels: ["kind/feature"]
|
||||||
|
body:
|
||||||
|
- type: dropdown
|
||||||
|
id: board
|
||||||
|
attributes:
|
||||||
|
label: Board
|
||||||
|
options: ["PC (SER5)", "Raspberry Pi 5", "Raspberry Pi 4 (not ported)", "Milk-V Mars", "Zynq-7020", "other"]
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: input
|
||||||
|
id: image
|
||||||
|
attributes:
|
||||||
|
label: Image
|
||||||
|
description: Which image was booted -- the nightly's Nexus version, or the commit it was built from.
|
||||||
|
placeholder: "kernelImage-2.1.0-20261107.030000-1-raspi5.img.xz, or 0fd7648a"
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: found
|
||||||
|
attributes:
|
||||||
|
label: What happened
|
||||||
|
description: How far it got -- the last line seen on serial or screen.
|
||||||
|
validations:
|
||||||
|
required: true
|
||||||
|
- type: textarea
|
||||||
|
id: log
|
||||||
|
attributes:
|
||||||
|
label: Serial log
|
||||||
|
description: The whole log if there is one; where it is committed (`logs/<TS>/...`).
|
||||||
|
render: text
|
||||||
|
- type: input
|
||||||
|
id: bringup
|
||||||
|
attributes:
|
||||||
|
label: boards/BRINGUP.md item
|
||||||
|
placeholder: "A1, S3, ..."
|
||||||
@@ -0,0 +1,6 @@
|
|||||||
|
# The issue picker. A blank issue is still allowed, for anything the forms do not fit.
|
||||||
|
blank_issues_enabled: true
|
||||||
|
contact_links:
|
||||||
|
- name: Design, documentation and discussion -- the project wiki
|
||||||
|
url: https://www.starshipos-f18.org/
|
||||||
|
about: The XWiki is the project's entry point. Issues here are for work in this repository.
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
## What and why
|
||||||
|
|
||||||
|
<!-- What this changes, and the ruling, issue or design section it carries out. -->
|
||||||
|
|
||||||
|
Closes #
|
||||||
|
|
||||||
|
## Acceptance
|
||||||
|
|
||||||
|
The **Acceptance** check runs on this pull request by itself -- amd64, aarch64, riscv64, the PC
|
||||||
|
stick loaded high, test-32 -- and `master` takes nothing that has not passed it. Note here
|
||||||
|
anything it does not cover:
|
||||||
|
|
||||||
|
- [ ] Logs from runs made by hand are committed in `logs/`, if any
|
||||||
|
- [ ] Hardware this was tried on, if any:
|
||||||
|
|
||||||
|
## The record
|
||||||
|
|
||||||
|
- [ ] `docs/fabric/FABRIC-3.md` has the ruling and what was built, if this is design work
|
||||||
|
- [ ] `CHANGELOG.md`, if it is a milestone
|
||||||
|
- [ ] Nothing in this PR is a fix nobody asked for (`.claude/CLAUDE.md`, Hard Rules)
|
||||||
Reference in New Issue
Block a user