Skip to content

docs: fix outdated content across CLI and user guides#121

Merged
EiffL merged 3 commits into
mainfrom
docs/update
May 8, 2026
Merged

docs: fix outdated content across CLI and user guides#121
EiffL merged 3 commits into
mainfrom
docs/update

Conversation

@aboucaud
Copy link
Copy Markdown
Member

@aboucaud aboucaud commented May 7, 2026

Summary

  • lc setup no longer exists — rewrote docs/cli/setup.md as a "removed" page and updated all references in install.md, troubleshooting.md, target.md, and cli/index.md to reflect that ~/.lightcone/config.yaml is auto-created on first use
  • lc eval status corrected in cli/index.md: it is registered on main when the eval extra is installed, not permanently broken
  • Added missing --json flag to docs/cli/status.md options table and examples
  • Removed non-existent lc run --dry-run from docs/user/cluster.md
  • Removed hooks from the plugin copy loop in troubleshooting.md and update.md — the hooks/ subdirectory is never shipped; hooks are wired via settings.json

Test plan

  • Verify lc --help output matches command table in cli/index.md
  • Confirm ~/.lightcone/config.yaml is auto-created on a fresh install without running any setup command
  • Check lc status --json emits valid JSON
  • Build docs site (just docs) and confirm no broken links to removed anchors

🤖 Generated with Claude Code

Signed-off-by: Alexandre Boucaud aboucaud@apc.in2p3.fr
Signed-off-by: Francois Lanusse EiffL@users.noreply.github.com

- Mark `lc setup` as removed; config is now auto-created on first use
- Remove `lc setup` from commands table and global-behavior description
- Correct `lc eval` status: available when `eval` extra is installed
- Add missing `--json` flag to `lc status` docs and examples
- Remove non-existent `--dry-run` flag from cluster.md
- Remove `hooks` from plugin copy loop (directory was never shipped)
- Update troubleshooting section to reflect auto-config creation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@aboucaud aboucaud requested a review from EiffL May 7, 2026 22:42
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented May 7, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
lightcone-cli d3ec0d3 Commit Preview URL

Branch Preview URL
May 08 2026, 09:25 AM

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

✅ Eval Results

Metric Value
Score 1.00
Build complete
Cost $0.84
Turns 32
Duration 421s
lightcone-cli 0.3.5.dev13+g6826e8152 (6826e815)
Results Download

Graders

✅ spec_valid (1.00)
✅ all_materialized (1.00)

Full output
09:24:56 lightcone.eval.build Building lightcone-cli wheel from /home/runner/work/lightcone-cli/lightcone-cli ...
09:25:01 lightcone.eval.build Built lightcone_cli-0.3.5.dev13+g6826e8152-py3-none-any.whl (commit 6826e815)
09:25:11 lightcone.eval.sandbox Created sandbox 7e26d4b8-54c0-4241-92f1-7fda27c0bacd for trial build-snae-0
09:25:11 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/7e26d4b8-54c0-4241-92f1-7fda27c0bacd/files/bulk-upload "HTTP/1.1 200 OK"
09:25:12 lightcone.eval.sandbox Installed wheels: ['lightcone_cli-0.3.5.dev13+g6826e8152-py3-none-any.whl']
09:25:13 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/7e26d4b8-54c0-4241-92f1-7fda27c0bacd/files/bulk-upload "HTTP/1.1 200 OK"
09:25:13 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/7e26d4b8-54c0-4241-92f1-7fda27c0bacd/files/bulk-upload "HTTP/1.1 200 OK"
09:25:13 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/7e26d4b8-54c0-4241-92f1-7fda27c0bacd/files/bulk-upload "HTTP/1.1 200 OK"
09:25:14 httpx HTTP Request: POST https://proxy.app.daytona.io/toolbox/7e26d4b8-54c0-4241-92f1-7fda27c0bacd/files/bulk-upload "HTTP/1.1 200 OK"
09:32:16 lightcone.eval.sandbox Deleted sandbox for trial build-snae-0
  snae trial 0: score=1.00 complete

lightcone-cli: 0.3.5.dev13+g6826e8152 (HEAD 6826e815)
ASTRA: 0.2.7

  Eval Results: Scores  
┏━━━━━━┳━━━━━━━━━━━━━━━┓
┃ Task ┃     Score     ┃
┡━━━━━━╇━━━━━━━━━━━━━━━┩
│ snae │ 1.00 +/- 0.00 │
│      │ pass@k: 100%  │
└──────┴───────────────┘

   Eval Results: Cost &   
         Duration         
┏━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ Task ┃ Cost / Duration ┃
┡━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ snae │      $0.84      │
│      │      421s       │
└──────┴─────────────────┘

Total: 1 trials, $0.84, 421s

Results saved to: eval-results/build-6826e815/results.json

Copy link
Copy Markdown
Member

@EiffL EiffL left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 8, 2026

Developer Certificate of Origin

All contributors have signed the DCO. This PR is ready to merge.

Status

@EiffL
Copy link
Copy Markdown
Member

EiffL commented May 8, 2026

I have read the Developer Certificate of Origin and I hereby sign the DCO for this PR

1 similar comment
@aboucaud
Copy link
Copy Markdown
Member Author

aboucaud commented May 8, 2026

I have read the Developer Certificate of Origin and I hereby sign the DCO for this PR

@EiffL EiffL merged commit 0f93a46 into main May 8, 2026
5 of 6 checks passed
@aboucaud aboucaud deleted the docs/update branch May 8, 2026 10:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants