fy59/lardon3d
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: update agent contract for current project state

Browse source
This commit is contained in:
fy59 2026-09-02 13:25:38 +02:00
parent 8434fcd773
commit 306ace2fb3
2 changed files with 23 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

35
AGENTS.md
View file

@ -41,7 +41,7 @@ Existing French documentation and source comments are to be converted to English
Historical documents may be translated, but translation must not modernize or reinterpret the historical state they record. Historical documents may be translated, but translation must not modernize or reinterpret the historical state they record.
User-interface language is a separate product concern. Existing TUI labels may remain in their current language until an explicit localization/product decision is made. Repository language policy does not require the UI to be English-only. The canonical user-interface language is also English. Existing non-English TUI labels must converge on English during an explicitly scoped UI-language remediation pass; documentation-only work must not silently modify executable UI behavior.
Canonical markers: Canonical markers:
@ -51,7 +51,7 @@ SOURCE_COMMENT_LANGUAGE=ENGLISH
AGENT_CONTRACT_LANGUAGE=ENGLISH AGENT_CONTRACT_LANGUAGE=ENGLISH
USER_INTERFACE_LANGUAGE=INDEPENDENT USER_INTERFACE_LANGUAGE=ENGLISH
## 2. FROZEN integrity ## 2. FROZEN integrity
@ -75,21 +75,18 @@ through an explicitly authorized, explicitly scoped human ticket:
- Durable Acquisition-Campaign Execution — PASS/FROZEN - Durable Acquisition-Campaign Execution — PASS/FROZEN
- Global Maintenance Audit — PASS/FROZEN - Global Maintenance Audit — PASS/FROZEN
- Real S21 Tracks scientific result — PASS/FROZEN - Real S21 Tracks scientific result — PASS/FROZEN
- Real A6000 pre-SfM scientific result — PASS/FROZEN
Detailed subcontracts remain defined by their canonical documents. This file Detailed subcontracts remain defined by their canonical documents. This file
must not duplicate every S3 substage, scientific threshold, migration detail, must not duplicate every S3 substage, scientific threshold, migration detail,
or persistence format. or persistence format.
Project DB v25 is the current additive operational schema in the active Feature Project DB v25 is the current additive operational schema. It preserves v24 RAW batch, the v23
batch tranche. It preserves v24 RAW batch, the v23 optical overlay and the v22 optical overlay and the v22 scientific/persistence foundation. Its additive purpose is typed durable
scientific/persistence foundation. Its authorized purpose is limited to typed persistence for `features.extract.batch/1` through `feature_extract_batch_tasks`; it adds no
durable persistence for `features.extract.batch/1` through scientific identity and must not reinterpret historical rows. The v25 Feature-batch path has completed
`feature_extract_batch_tasks`; it adds no scientific identity and must not its retained real A6000 proof. Historical references to older Project DB versions remain valid where
reinterpret historical rows. Until the v25/Feature-batch tranche has completed they describe the actual historical contract or migration path.
its real-data proof and final review, its lifecycle must remain truthful rather
than being marked `PASS/FROZEN` prematurely. Historical references to older
Project DB versions remain valid where they describe the actual historical
contract or migration path.
The global maintenance implementation, fresh portable/Vulkan/sanitizer/ The global maintenance implementation, fresh portable/Vulkan/sanitizer/
concurrency validation and independent final review are acquired. Its lifecycle concurrency validation and independent final review are acquired. Its lifecycle
@ -108,6 +105,12 @@ their directly affected contracts, tests, documentation, and crossed dependency
boundaries. Unchanged PASS/FROZEN systems inherit this evidence and are reopened boundaries. Unchanged PASS/FROZEN systems inherit this evidence and are reopened
only by concrete evidence; do not repeat a global A-to-Z audit. only by concrete evidence; do not repeat a global A-to-Z audit.
The later real-data checkpoint is tag `real-a6000-pre-sfm-2026-09-02`. It establishes
`REAL_A6000_PRE_SFM=PASS/FROZEN` through Geometric Verification and Tracks while explicitly
leaving Sparse SfM and Dense/MVS unexecuted. This checkpoint adds later operational and real-data
evidence; it does not erase or replace the `global-maintenance-2026-09-01` review authority for
unchanged FROZEN systems.
When a ticket declares `NO_NEW_SUBSYSTEM`, do not introduce an unrelated: When a ticket declares `NO_NEW_SUBSYSTEM`, do not introduce an unrelated:
- Task Runtime; - Task Runtime;
@ -242,7 +245,7 @@ explicitly defines such an identity.
progress distinct from generic runtime percentage, and keep unknown progress distinct from generic runtime percentage, and keep unknown
provenance visibly UNKNOWN. Full layout starts at 100x30, compact is provenance visibly UNKNOWN. Full layout starts at 100x30, compact is
supported through 60x15 (72x20 is the reference compact boundary), and only supported through 60x15 (72x20 is the reference compact boundary), and only
the bounded "Terminal trop petit" fallback is allowed below that minimum. the bounded terminal-too-small fallback is allowed below that minimum.
- Preserve the contextual key contract. `F10 SSD` remains literally visible at - Preserve the contextual key contract. `F10 SSD` remains literally visible at
60 columns in idle, text-input and import-running modes; text input owns only 60 columns in idle, text-input and import-running modes; text input owns only
Enter/Escape/F10 and a running import owns only cancel (`X`) and F10 while Enter/Escape/F10 and a running import owns only cancel (`X`) and F10 while
@ -797,7 +800,9 @@ For Project DB:
overlay; overlay;
- v24 is the explicitly authorized additive operational RAW-batch migration and - v24 is the explicitly authorized additive operational RAW-batch migration and
must not reinterpret scientific history; must not reinterpret scientific history;
- future schema-version changes beyond the currently authorized v24 require - v25 is the additive Feature-batch migration for `features.extract.batch/1` and
must preserve v22/v23/v24 identities, rows and semantics;
- future schema-version changes beyond the current v25 head require
explicit human authorization; explicit human authorization;
- migrations must be additive unless a different migration is explicitly - migrations must be additive unless a different migration is explicitly
authorized; authorized;
@ -1015,7 +1020,7 @@ Every completed ticket report must include:
STOP and request a human decision only when resolution requires: STOP and request a human decision only when resolution requires:
- changing a FROZEN scientific contract; - changing a FROZEN scientific contract;
- changing Project DB schema/version beyond already authorized v24 without - changing Project DB schema/version beyond the current v25 head without
prior authorization; prior authorization;
- introducing a genuinely new subsystem outside authorized scope; - introducing a genuinely new subsystem outside authorized scope;
- files outside the authorized scope; - files outside the authorized scope;

6
docs/audits/documentation_inventory.md
View file

@ -423,13 +423,13 @@ The final repository target is:
- DOCUMENTATION_LANGUAGE=ENGLISH - DOCUMENTATION_LANGUAGE=ENGLISH
- SOURCE_COMMENT_LANGUAGE=ENGLISH - SOURCE_COMMENT_LANGUAGE=ENGLISH
- AGENT_CONTRACT_LANGUAGE=ENGLISH - AGENT_CONTRACT_LANGUAGE=ENGLISH
- USER_INTERFACE_LANGUAGE=INDEPENDENT - USER_INTERFACE_LANGUAGE=ENGLISH
All technical documentation, agent contracts, prompt files and production source comments are to converge on English during the remediation passes. All technical documentation, agent contracts, prompt files and production source comments are to converge on English during the remediation passes.
Translation must preserve scientific meaning, historical truth, FROZEN contracts, identities, numeric values, lifecycle state and evidence. A historical document may be translated but must not be silently modernized. Translation must preserve scientific meaning, historical truth, FROZEN contracts, identities, numeric values, lifecycle state and evidence. A historical document may be translated but must not be silently modernized.
The TUI language is a separate product/localization decision and is not changed by this documentation-language decision. The canonical TUI language is English. Existing non-English UI strings are to be remediated in an explicitly scoped UI-language pass; this documentation audit does not itself authorize executable UI changes.
# Product documentation intentionally deferred # Product documentation intentionally deferred
@ -567,7 +567,7 @@ No mass source-comment editing is authorized by this inventory.
# Phase state # Phase state
- DOCUMENTATION_INVENTORY_AUDIT=PASS_WITH_FINDINGS - DOCUMENTATION_INVENTORY_AUDIT=PASS_WITH_FINDINGS
- DOCUMENTATION_REMEDIATION=NOT_STARTED - DOCUMENTATION_REMEDIATION=IN_PROGRESS
- SOURCE_COMMENT_AUDIT=NOT_STARTED - SOURCE_COMMENT_AUDIT=NOT_STARTED
- PRODUCT_DEFINITION=NOT_STARTED - PRODUCT_DEFINITION=NOT_STARTED
- PROMPT_TREE=NOT_STARTED - PROMPT_TREE=NOT_STARTED