mars_nwe/mars-nwe
1
0
Fork 0
Code Issues Pull Requests Actions Projects Releases 2 Wiki Activity

0453 docs: record patch-only export and author rules
All checks were successful
Source release / source-package (push) Successful in 1m43s
Details

Browse Source
This commit is contained in:
Mario Fetka
2026-06-13 05:56:02 +00:00
committed by Mario Fetka
parent fcf900e360
commit 4e07acd6c8
1 changed files with 14 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
AI.md
View File

@@ -46,7 +46,7 @@ unfinished work out of `TODO.md` merely because its architecture is documented.
Latest patch marker expected in an up-to-date bundle:
- `0452 docs: keep AI patch handoff block replaceable`
- `0453 docs: record patch-only export and author rules`
When a later chat receives a new `mars-nwe-master` bundle, compare `git log -1`
with this marker. If the uploaded bundle already contains this commit subject,
@@ -66,15 +66,15 @@ The active line is expected to include:
Last generated patch:
- `0452 docs: keep AI patch handoff block replaceable`
- `0453 docs: record patch-only export and author rules`
Purpose of that patch:
- Make this section the single replaceable patch handoff marker. Every later
repository patch must replace this block with its own final commit subject and
a short description of what the patch was meant to do. Do not append a new
handoff section for every patch, because that would make `AI.md` grow without
bound and recreate the old chat-end problem.
- Record that future repository changes should export only the `git am` patch
file by default, not a bundle, and that generated patch mail headers must use
`Mario Fetka <mario.fetka@disconnected-by-peer.at>` as author identity.
Keep this block replaceable: every later patch must overwrite it with the
next commit subject and short patch purpose instead of appending history.
Rejected or superseded patches that must not be reused as-is:
@@ -139,17 +139,20 @@ work.
- Inspect current sources before editing; no speculative patching.
- Run at least `git diff --check` before exporting a patch.
- Also run syntax/build/test checks that match the touched files when feasible.
- Provide both a `.patch` and a `.bundle` when producing repository changes.
- Export only the `.patch` file by default when producing repository changes.
Do not create or link a bundle unless the user explicitly asks for one.
- Every repository patch must update this `AI.md` with the new final commit
subject in the current patch marker before exporting the patch. This makes a
later uploaded bundle self-identifying even when old chat downloads have
expired or are unavailable.
subject in the current patch marker before exporting the patch. If the user
later uploads a bundle from their repository, the marker makes that bundle
self-identifying even when old chat downloads have expired or are unavailable.
- Every repository patch must also replace the single `Current patch handoff
block` in this file with a short description of what the patch was meant to
do. Replace the old block; do not append a new one for every patch.
- Always include a copy/paste `git am <patch-name>.patch` command in the user
response next to the patch download link. This is part of the handoff
contract, not an optional nicety.
- Generate patch mail headers with `Mario Fetka <mario.fetka@disconnected-by-peer.at>`
as the author identity, not an AI/OpenAI identity.
- Do not claim a build/test passed unless it actually ran in the current work
tree.