projectfile.org

org.projectfile.cli

Bookkeeping surface for the projectfile CLI: derived[] tracks every field path the CLI has populated via the derivation layer (forge URLs, registry URLs) so subsequent runs can re-derive without trampling user edits, and derive.* toggles disable individual inference passes. Removing a path from derived[] is the user-side opt-out marker. Note: includes[] was promoted to the root-level reserved field includes (spec §4.10a).

  • Namespace: org.projectfile.cli
  • Owner: projectfile.org (projectfile CLI tooling)
  • Status: proposed
Section titled “Links”

Produced by

Section titled “Produced by”

Shape

Section titled “Shape”

Illustrative fragment — not a complete projectfile document. Consumers MUST round-trip unknown namespaces even when no shape is published.

---# SPDX-FileCopyrightText: 2026 Damián Búho <damian.buho@proton.me>## SPDX-License-Identifier: CC-BY-4.0# SPDX-License-Identifier: MIT
# Shape: org.projectfile.cli extension namespace# Illustrative fragment — not a complete projectfile document.# See registry.yaml for ownership and status.## This namespace carries the derive toggles the CLI uses to control its# inference passes. Derived-link attribution moved to the links themselves:# each link the CLI auto-populates carries derived: true directly on the# link entry rather than as a path list in this extension.## Note: includes[] was moved to the root-level `includes` reserved field# (spec §4.10a) and is no longer carried in this namespace.
org:  projectfile:    cli:
      # Per-source toggles for the derivation layer. All default to true.      derive:        forges: true # GitHub/GitLab/Codeberg/sourcehut → bugs URL

.onion.i2p