go-libfossil: Artifact [919468c3c8]

Artifact 919468c3c8a2691aa0425c97a31bc1f68b5ea2c7d908afdbf6abba4d4eb1483f:

File docs/site/content/docs/reference/cli/repo-cone.md — part of check-in [d7fd910ffc] at 2026-10-23 21:12:43 on branch main — docs: generate the site's data, CLI reference and llms.txt from the code
tools/docsgen/engine records one check-in as an artifact, as its derived rows and as the cards of a pull, from a real engine run with fixed inputs. tools/docsgen/conformance turns TestCoverage's report into per-draft and per-requirement data. scripts/gen-cli-docs.sh writes one page per command group from the libfossil binary's --help. gen-llms-txt.sh and check-llms-txt.sh are ported from dagnats, and sync-version.sh now takes the highest release tag and writes the go.mod version too.
scripts/check-docs-generated.sh regenerates everything into a scratch dir and fails on any difference; make docs-check and the test-docs CI job run it. (user: [email protected], size: 8561) [annotate] [blame] [check-ins using] [more...]

title: 'repo cone' weight: 430 generated: true

description: 'Show or edit a checkout''s sparse cone'

Usage: libfossil repo cone <command>

Show or edit a checkout's sparse cone

Flags:
  -h, --help           Show context-sensitive help.
  -R, --repo=STRING    Path to repository file
  -v, --verbose        Verbose output

Commands:
  repo cone show [flags]
    List the cone's members ("dense" when there is none)

  repo cone add <paths> ... [flags]
    Widen the cone, or with --not carve paths out of it

  repo cone remove <paths> ... [flags]
    Remove members of either polarity

  repo cone set <paths> ... [flags]
    Replace the cone

  repo cone dense [flags]
    Drop the cone and materialize every file

  repo cone test <paths> ... [flags]
    Classify paths against the cone and name the deciding member

  repo cone store [<paths> ...] [flags]
    Show or replace the repository's store cone, fetching what widening covers

  repo cone deepen <checkin> [flags]
    Move the store's horizon down to reach a check-in, fetching the history it
    keeps

  repo cone compact
    Drop held blobs the store cone elides (irreversible locally)

  repo cone cost <checkin>
    Report what each horizon rule would hold at a check-in, from this repository

repo cone show

Usage: libfossil repo cone show [flags]

List the cone's members ("dense" when there is none)

Flags:
  -h, --help           Show context-sensitive help.
  -R, --repo=STRING    Path to repository file
  -v, --verbose        Verbose output

  -d, --dir="."        Checkout directory

repo cone add

Usage: libfossil repo cone add <paths> ... [flags]

Widen the cone, or with --not carve paths out of it

Arguments:
  <paths> ...    Paths to add

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it
      --not                 Add the paths as exclusions
  -d, --dir="."             Checkout directory

repo cone remove

Usage: libfossil repo cone remove <paths> ... [flags]

Remove members of either polarity

Arguments:
  <paths> ...    Members to remove

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it
  -d, --dir="."             Checkout directory

repo cone set

Usage: libfossil repo cone set <paths> ... [flags]

Replace the cone

Arguments:
  <paths> ...    Inclusion members

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it
      --not=NOT,...         Exclusion members (repeatable)
  -d, --dir="."             Checkout directory

repo cone dense

Usage: libfossil repo cone dense [flags]

Drop the cone and materialize every file

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it
  -d, --dir="."             Checkout directory

repo cone test

Usage: libfossil repo cone test <paths> ... [flags]

Classify paths against the cone and name the deciding member

Arguments:
  <paths> ...    Paths to classify

Flags:
  -h, --help           Show context-sensitive help.
  -R, --repo=STRING    Path to repository file
  -v, --verbose        Verbose output

  -q, --quiet          Print nothing; report through the exit status only
  -d, --dir="."        Checkout directory

repo cone store

Usage: libfossil repo cone store [<paths> ...] [flags]

Show or replace the repository's store cone, fetching what widening covers

Arguments:
  [<paths> ...]    Inclusion members; none shows the store cone

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it
      --not=NOT,...         Exclusion members (repeatable)
      --dense               Drop the store cone, fetching everything it elided
      --horizon=STRING      Elide blobs below this check-in (name, branch or
                            hash prefix), fetching what a deeper horizon keeps;
                            'repo cone cost' shows what each rule would hold
      --leaves              With --horizon, also hold every open leaf's ancestry
                            back to the check-in, for merging across live
                            branches offline; costly: on a repository with old
                            unmerged branches that is nearly the whole history
      --structural          With --horizon, also elide the manifests below the
                            check-in; the next pull fetches the origin's seed
      --no-horizon          Drop the horizon, keeping the path members,
                            and fetch what it elided

repo cone deepen

Usage: libfossil repo cone deepen <checkin> [flags]

Move the store's horizon down to reach a check-in, fetching the history it keeps

Arguments:
  <checkin>    Check-in to reach: a full hash, which may lie below the horizon,
               or a name

Flags:
  -h, --help                Show context-sensitive help.
  -R, --repo=STRING         Path to repository file
  -v, --verbose             Verbose output

      --remote=STRING       Required-content peer URL (default: saved
                            last-sync-url)
      --sync-user=STRING    Required-content authentication user
      --sync-pass=STRING    Required-content password (never saved)
      --sync-private        Allow recovery of private required artifacts
      --timeout=10m         Required-content deadline; 0 disables it

repo cone compact

Usage: libfossil repo cone compact

Drop held blobs the store cone elides (irreversible locally)

Flags:
  -h, --help           Show context-sensitive help.
  -R, --repo=STRING    Path to repository file
  -v, --verbose        Verbose output

repo cone cost

Usage: libfossil repo cone cost <checkin>

Report what each horizon rule would hold at a check-in, from this repository

Arguments:
  <checkin>    Check-in to place the horizon at: a name, branch or hash prefix

Flags:
  -h, --help           Show context-sensitive help.
  -R, --repo=STRING    Path to repository file
  -v, --verbose        Verbose output