mirror of
https://github.com/allaunthefox/SilverSight.git
synced 2026-07-31 01:25:21 +00:00
docs: enforce CFF 1.2.0 standards
- Convert placeholder paper references from type: article to type: unpublished with honest notes about pending identifiers - Remove fake journal/arXiv placeholder from Giani et al. - Add CFF standards section to AGENTS.md with validation command and rules for DOIs, preprints, non-academic sources, and et al. usage Build: 2978 jobs, 0 errors (lake build)
This commit is contained in:
parent
6fcea90e4e
commit
d0159ce91d
2 changed files with 34 additions and 9 deletions
25
AGENTS.md
25
AGENTS.md
|
|
@ -262,7 +262,30 @@ Current Research Stack cornfield ref (for cross-repo lookup only):
|
|||
|
||||
---
|
||||
|
||||
## 13. SilverSight-Specific Boundaries
|
||||
## 13. Citation File Format (CFF) Standards
|
||||
|
||||
`CITATION.cff` must remain valid CFF 1.2.0 and be checked after any edit.
|
||||
|
||||
- Run `python3 -c "import yaml; yaml.safe_load(open('CITATION.cff'))"` to verify
|
||||
YAML syntax.
|
||||
- Include all required fields: `cff-version`, `message`, `title`, `authors`,
|
||||
`type`.
|
||||
- Use `repository-code` and `url` for the project; add `date-released` and
|
||||
`license` when known.
|
||||
- For references:
|
||||
- Prefer DOI or arXiv ID. Use `url` only when no persistent identifier exists.
|
||||
- Use `type: unpublished` for preprints or works without a confirmed venue;
|
||||
do not invent journal names or placeholder identifiers.
|
||||
- For non-academic sources (e.g. Reddit posts, blog posts, forum threads),
|
||||
use `type: generic` or `type: misc` with a `url` and `date-accessed` note.
|
||||
- Avoid `et al.` as an author entry when a full author list is available;
|
||||
use it only as a last resort for long author lists.
|
||||
- When porting from Research Stack, add Research Stack as a `software`
|
||||
reference, not as a co-author.
|
||||
|
||||
---
|
||||
|
||||
## 14. SilverSight-Specific Boundaries
|
||||
|
||||
- `Core/SilverSightCore.lean` is the root authority. It contains no sorries in
|
||||
the active surface.
|
||||
|
|
|
|||
18
CITATION.cff
18
CITATION.cff
|
|
@ -60,9 +60,9 @@ references:
|
|||
notes: "Parent research repository from which SilverSight ports proven Lean modules, agent contracts, and fixed-point semantics."
|
||||
|
||||
# NOTE: The following four references are domain sources used by the
|
||||
# PVGS_DQ_Bridge and BindingSite libraries. arXiv IDs and DOIs should be
|
||||
# back-filled once the final preprint identifiers are confirmed.
|
||||
- type: article
|
||||
# PVGS_DQ_Bridge and BindingSite libraries. They are recorded as
|
||||
# `unpublished` until DOIs, arXiv IDs, or journal pages are confirmed.
|
||||
- type: unpublished
|
||||
authors:
|
||||
- family-names: "Giani"
|
||||
given-names: "A."
|
||||
|
|
@ -72,9 +72,8 @@ references:
|
|||
given-names: "C."
|
||||
title: "Photon-Varied Gaussian States"
|
||||
year: 2025
|
||||
journal: "arXiv:2505.XXXXX"
|
||||
notes: "Placeholder arXiv ID pending final preprint assignment."
|
||||
- type: article
|
||||
notes: "Preprint / in-preparation. Identifier pending confirmation."
|
||||
- type: unpublished
|
||||
authors:
|
||||
- family-names: "Chabaud"
|
||||
given-names: "U."
|
||||
|
|
@ -82,17 +81,20 @@ references:
|
|||
given-names: "S."
|
||||
title: "Stellar representation of non-Gaussian quantum states"
|
||||
year: 2022
|
||||
- type: article
|
||||
notes: "Full citation details pending DOI or arXiv ID."
|
||||
- type: unpublished
|
||||
authors:
|
||||
- family-names: "Pizzimenti"
|
||||
given-names: "C."
|
||||
- family-names: "et al."
|
||||
title: "Wigner negativity of superpositions"
|
||||
year: 2024
|
||||
- type: article
|
||||
notes: "Full citation details pending DOI or arXiv ID."
|
||||
- type: unpublished
|
||||
authors:
|
||||
- family-names: "Wassner"
|
||||
given-names: "M."
|
||||
- family-names: "et al."
|
||||
title: "Single quadrature noise tomography"
|
||||
year: 2025
|
||||
notes: "Full citation details pending DOI or arXiv ID."
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue