Skip to content

v0.7.0

Choose a tag to compare

@jesshart jesshart released this 29 Apr 17:48
· 5 commits to main since this release

Added

  • croc bask <root> [-o OUT] [--rewrite-refs/--no-rewrite-refs] [--force] [--dry-run] [--strict-refs] — flatten a markdown tree
    into a single output directory. Every .md under root is emitted
    to OUT with its relative path encoded into the filename via __
    (dunder) joiners; non-md files are ignored. Markdown path-refs
    ([text](path.md)) in body text are rewritten to point at the
    flattened siblings by default, with anchors preserved; pass
    --no-rewrite-refs for a byte-for-byte raw export. Croc id-refs
    ([[id:X]]) are stable and pass through untouched. Output defaults
    to ./tmp/<root-name>-bask/, overridable with -o. Refs that
    escape the bask root or don't resolve to a .md in the input
    surface as SKIP-REF notes; pass --strict-refs to exit non-zero
    when any are present. Bask refuses to run when an input path
    segment already contains the __ joiner — surfaces every offender
    at once so the user renames them in one pass. Intended for one-way
    export to tools that don't traverse directories (LLM context
    loaders, embedding pipelines, dump-to-clipboard flows); there is
    no inverse operation. Honors the global --include-untracked flag.