Skip to content

Releases: crate/about

v0.0.9

03 Nov 12:57

Choose a tag to compare

What's Changed

  • Outline: Improved llms-txt's get_doc_content to fail on
    resources with HTTP != 200
  • Outline: Fixed broken links to documentation
  • CI: Started running software tests each night to catch regressions

Details

  • Update claudette requirement from <0.3 to <0.4 by @dependabot[bot] in #63
  • Update anthropic requirement from <0.60 to <0.65 by @dependabot[bot] in #72
  • Update tiktoken requirement from <0.10 to <0.12 by @dependabot[bot] in #70
  • Bump actions/checkout from 4 to 5 by @dependabot[bot] in #74
  • Update pytest-cov requirement from <7 to <8 by @dependabot[bot] in #77
  • Update ruff requirement from <0.13 to <0.14 by @dependabot[bot] in #79
  • Update anthropic requirement from <0.65 to <0.68 by @dependabot[bot] in #78
  • Bump actions/setup-python from 5 to 6 by @dependabot[bot] in #84
  • Update mypy requirement from <1.18 to <1.19 by @dependabot[bot] in #80
  • Update anthropic requirement from <0.68 to <0.70 by @dependabot[bot] in #83
  • Update openai requirement from <2 to <3 by @dependabot[bot] in #85
  • Update tiktoken requirement from <0.12 to <0.13 by @dependabot[bot] in #86
  • Update ruff requirement from <0.14 to <0.15 by @dependabot[bot] in #87
  • Chore: Fix software tests by @amotl in #93
  • Update anthropic requirement from <0.70 to <0.73 by @dependabot[bot] in #90
  • Bump astral-sh/setup-uv from 6 to 7 by @dependabot[bot] in #92
  • Update hishel requirement from <0.2 to <1.1 by @dependabot[bot] in #91
  • Revert updating to Hishel 1.x and add better integration test by @amotl in #95
  • Outline: Add integration test with real cratedb-outline.yaml by @amotl in #97
  • Outline: Improve llms-txt's get_doc_content to fail on errors by @amotl in #98
  • Instructions: Balance responsibilities. Advise language. by @amotl in #99
  • Python 3.14: Validate on CI and adjust for deprecations by @amotl in #94

Full Changelog: v0.0.8...v0.0.9

v0.0.8

28 Jul 09:45

Choose a tag to compare

What's Changed

  • Outline: Shrank llms-txt output to <200_000 input tokens
  • Bundle: Added "count-tokens" procedure to inform about the size
    of the outcome. Sonnet and Opus are limited to 200_000 input tokens.
  • Query: Added a few more example questions specific to CrateDB
  • Naming things: Renamed OutlineItems.to_dict to OutlineItems.to_list
  • Prompt (instructions.md): Reorganized and improved the CrateDB prompt
    instructions for clarity and structure

Details

  • Outline: Shrink llms-txt output to <200_000 input tokens by @amotl in #57
  • Bundle: Added "count-tokens" procedure to inform about the size by @amotl in #59
  • Query: Add a few more example questions specific to CrateDB by @amotl in #60
  • Naming things: Rename OutlineItems.to_dict to OutlineItems.to_list by @amotl in #61
  • Prompt: Reorganize and improve instructions about working with CrateDB by @amotl in #62

Full Changelog: v0.0.7...v0.0.8

v0.0.7

22 Jul 09:20

Choose a tag to compare

What's Changed

  • Prompt: Educate about standalone use with llm program by @amotl in #53

Full Changelog: v0.0.6...v0.0.7

v0.0.6

21 Jul 17:49

Choose a tag to compare

What's Changed

  • Prompt: Added instructions about working with CrateDB to be used for
    LLM system prompts. Thanks, @hammerhead and @WalBeh.

Details

  • Update mypy requirement from <1.16 to <1.17 by @dependabot[bot] in #46
  • Update cattrs[pyyaml] requirement from <25 to <26 by @dependabot[bot] in #47
  • Update claudette requirement from <0.2 to <0.3 by @dependabot[bot] in #48
  • Update ruff requirement from <0.12 to <0.13 by @dependabot[bot] in #49
  • Update mypy requirement from <1.17 to <1.18 by @dependabot[bot] in #50
  • Update claudette requirement from <0.3 to <0.4 by @dependabot[bot] in #51
  • Prompt: Add instructions about working with CrateDB by @amotl in #52

Full Changelog: v0.0.5...v0.0.6

v0.0.5

19 May 21:34

Choose a tag to compare

What's Changed

  • Bundle: Added outline in Markdown format, which got lost previously
  • Inventory: Added general information about partitioned tables, storage,
    replication, and views, and more specific information about the
    {CREATE,ALTER} [FOREIGN] TABLE [AS] and COPY {FROM,TO} commands.
  • Inventory: Added information about SQL data types and about how to import
    example datasets using CrateDB Toolkit.
  • Bundle: Fixed semantics of llms.txt vs. llms-full.txt, see ABOUT-39.
  • Bundle: Generated outline.html for improved inspection by humans
  • Inventory: Prioritized technical content because context windows are limited.
    Most LLM implementations will truncate input in some way or another.

Details

  • Bundle: Added outline in Markdown format, which got lost previously by @amotl in #37
  • Inventory: Add more relevant general and specific information by @amotl in #41
  • Bundle: Fix semantics of llms.txt vs. llms-full.txt by @amotl in #42
  • Inventory adjustments by @amotl in #43

Full Changelog: v0.0.4...v0.0.5

v0.0.4

16 May 11:11

Choose a tag to compare

What's Changed

  • Outline: cratedb-about outline now understands --url option to use any outline resource on local or remote filesystems. Alternatively, use the ABOUT_OUTLINE_URL environment variable.
  • Outline: Added to_llms_txt API method and CLI options --format=llms-txt and --optional, to directly convert/expand the source outline file into an llms.txt file.
  • llms-txt: Renamed subcommand build to bundle --format=llms-txt
  • Outline: Refactored quirky as_dict parameter to more fluent .to_dict() interface
  • Query: Added a few example questions specific to CrateDB
  • Outline: Renamed CRATEDB_CONTEXT_URL to ABOUT_CONTEXT_URL
  • Outline: Fixed llms_txt currently does not accept newlines in description fields
  • Inventory: Significantly update cratedb-outline.yaml
  • Bundle: Started accepting --url/ABOUT_OUTLINE_URL option to specify alternative input outline file
  • Bundle: Improved handling of --format option
  • Query: Permitted loading context file from local filesystem per ABOUT_CONTEXT_URL
  • Query: Introduced caching for context payloads on HTTP remote URLs
  • llms-txt: Introduced caching for expanding outline into Markdown file
  • Inventory: Added information about user and role management, privilege assignment, and multi-tenancy implementation suggestions
  • Bundle: Provided README in HTML format per readme.html

Details

  • Outline: Make cratedb-about outline understand --url option by @amotl in #21
  • Update pytest-cov requirement from <6 to <7 by @dependabot in #26
  • Update twine requirement from <6 to <7 by @dependabot in #27
  • README: Add a few elaborations and refinements by @amotl in #22
  • Outline: Add to_llms_txt API method and --format=llms-txt CLI option by @amotl in #23
  • This and that, mostly naming things by @amotl in #25
  • Outline: Significantly update cratedb-outline.yaml by @amotl in #28
  • Bundle: Start accepting --url/ABOUT_OUTLINE_URL option by @amotl in #34
  • Query: Permit loading context file from local filesystem by @amotl in #29
  • Query: Introduce caching for context payloads on HTTP remote URLs by @amotl in #31
  • llms-txt: Introduce caching for expanding outline into Markdown file by @amotl in #33
  • Inventory: Inform about user management and privilege assignment by @amotl in #32
  • Bundle: Provide README in HTML format per readme.html by @amotl in #35

Full Changelog: v0.0.3...v0.0.4

v0.0.3

10 May 09:04

Choose a tag to compare

What's Changed

  • Data backend: Refactored the source of truth for the documentation outline
    into the package itself, to cratedb-outline.yaml
  • CLI: Provided new subcommand cratedb-about outline
  • API: Provided cratedb_about.CrateDbKnowledgeOutline for retrieving
    information from the knowledge base outline within Python programs
  • CLI: Zapped working tree building by establishing a new cratedb-about build
    subcommand
  • CI: Added GHA workflow for publishing package to PyPI
  • API: Improved data model and interface
  • API: Refactored LLM conversations code to CrateDbKnowledgeConversation

Details

  • Chore: Clean up build folder. Sources should be in src. by @amotl in #13
  • Chore: Use public_html as build folder. build is used for Python. by @amotl in #14
  • Data backend: Refactor the source of truth to cratedb-outline.yaml by @amotl in #15
  • CLI: Zap working tree building by establishing cratedb-about build by @amotl in #16
  • CI: Add GHA workflow for publishing package to PyPI by @amotl in #17
  • This and that by @amotl in #18
  • This and that II by @amotl in #19

Full Changelog: v0.0.2...v0.0.3

v0.0.2

09 May 13:35

Choose a tag to compare

What's Changed

  • Chore: Removed sponge command in poe build
  • Content: Added two pieces of content from blog articles, converted to Markdown format
  • Documentation: Started advertising to use the designated location
    https://cdn.crate.io/about/ for consuming the generated resources
  • Naming things: Adhered to the naming convention of [LLMs.txt Hub]
    by using llms.txt and llms-full.txt.
  • Content: Added the [CrateDB README]

Details

  • Bump astral-sh/setup-uv from 5 to 6 by @dependabot in #9
  • Content: Add two pieces of content from blog articles, converted to Markdown format by @amotl in #2
  • cratedb-about ask: Use location /about by @amotl in #10
  • Naming things: Adhere to the naming convention of https://llmtxt.dev/hub by @amotl in #11
  • Content: Add the CrateDB README by @amotl in #12

New Contributors

Full Changelog: v0.0.1...v0.0.2

v0.0.1

09 May 13:35

Choose a tag to compare

What's Changed

  • Established project layout
  • Added source files (cratedb-overview.md), generator program wrapper
    (uv run poe build), and build artifacts (llms-ctx.txt and llms-ctx-full.txt)
  • Added CLI program cratedb-about with subcommands ask and list-questions
    for ad hoc conversations about CrateDB

Details

  • What is CrateDB? / What can you do with CrateDB, and how? by @amotl in #1
  • Build llms.txt files from source cratedb-overview.md by @amotl in #3
  • Add CLI program cratedb-about ask for conversations about CrateDB by @amotl in #4

Full Changelog: https://github.com/crate/about/commits/v0.0.1