Skip to content

bug: docs/concepts.md lists build as a public command but codealmanac build is rejected #35

Description

@Priyanshubhartistm

What happened?

The command-group table in docs/concepts.md says:

| Lifecycle | `init`, `build`, `ingest`, `garden`, `sync`, `jobs` | ... |

But build is deliberately not a public command — it is an internal run kind that init queues (that design is locked in implementation-tickets.md Ticket 13: "codealmanac build is not public", with a test that the parser rejects it). Running it confirms:

$ codealmanac build
◆ codealmanac

Unknown command
...

Anyone (human or agent) reading concepts.md as the product model will try a command that renders an error screen.

What did you expect?

The Lifecycle row to list only the real public commands: init, ingest, garden, sync, jobs. If it's useful to keep the concept visible, a sentence like "init queues an internal build run" matches the rest of the doc without advertising a fake command.

Reproduction

grep -n '`build`' docs/concepts.md
codealmanac build   # rejected with the Unknown command screen

Environment

  • OS: any
  • Python version: 3.12
  • CodeAlmanac version: 0.3.7
  • Install method: local checkout
  • Agent provider, if relevant: none
  • Almanac root, if relevant: almanac/

Logs or output

$ codealmanac build
◆ codealmanac

Unknown command

You ran:
  codealmanac build

Extra context

almanac/reference/cli/public-command-surface.mdh agree on the real surface; concepts.md is theonly doc out of sync.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions