Skip to content

docs: document the no recipe status and the report without ok - #39

Draft
EiffL wants to merge 1 commit into
mainfrom
materialize-report-no-ok
Draft

EiffL wants to merge 1 commit into
mainfrom
materialize-report-no-ok

Conversation

@EiffL

@EiffL EiffL commented Oct 15, 2026

Copy link
Copy Markdown
Member

Documents the lightcone-cli behaviour from LightconeResearch/lightcone-cli#241, plus the matching skill change in LightconeResearch/agent-skills#54. Draft until a CLI release includes #241: the pages currently describe the released 0.5.0, which still has ok and doesn't list recipe-less outputs.

What #241 changes

  • no recipe state. An output declared without a recipe used to vanish from lc status. It's now listed with the state no recipe, and counts["no recipe"] counts such outputs.
  • No ok key. The materialize report no longer has ok. In check mode it said true while the command exited 1, and agents read it as "done".
  • The gate's scope is unchanged. lc materialize --check still passes over recipe-less outputs, because it predicts what a run would do and a run skips them. "Finished" therefore means the check passes and lc status lists no no recipe output.

Pages

  • lightcone-cli/commands/materialize.mdx: ok is gone from the JSON example; a check passes on up_to_date, a run succeeds when failed and blocked are empty; recipe-less outputs are never planned.
  • lightcone-cli/commands/status.mdx: the new state in the example output (status column one character wider, as the CLI now prints it), in the states list, and in counts; a paragraph on the gate's scope.
  • lightcone-cli/concepts.mdx: up_to_date is the key to test; the check covers only outputs with a recipe.
  • agent-skills/lightcone.mdx: four states, and the "done" and "ready to publish" conditions, matching agent-skills#54.

Not changed: lightcone-lab/features.mdx says the Lab pipeline marks outputs "current, behind or stale". That depends on what the Lab renders, not on lc.

npm run build passes.

🤖 Generated with Claude Code

lightcone-cli#241 lists outputs declared without a recipe in `lc status`
as `no recipe`, and removes `ok` from the materialize report.

- commands/materialize: drop `ok` from the JSON example; read the report
  by `up_to_date` (check) and `failed`/`blocked` (run); recipe-less
  outputs are never planned.
- commands/status: the new state in the example, the states list and
  `counts`; the gate covers only outputs with a recipe.
- concepts: `up_to_date` is the key to test; the check's scope.
- agent-skills/lightcone: four states, and "done" also needs no
  `no recipe` output, matching agent-skills#54.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 15, 2026 2:57pm UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — 078f4dc7 Deployed Oct 15, 2026 by vercel[bot]
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.

1 participant