Skip to content

Ocura OSS 0.7.0

Choose a tag to compare

@github-actions github-actions released this 01 Nov 17:50
· 12 commits to main since this release
db15ec5
  • Keep the demo and history inspection as the primary example in the core
    repository. Move the autoregressive demonstration and its backend tests to the
    semi-permanent examples/0.7 branch, alongside the CI-report and Dream examples.
    Link their setup and compatibility requirements from the use-case catalog.
  • On Windows, verify no longer reports an unreadable attempt when a concurrent
    run finalizes while it reads; a read denied while the record still exists is
    retried briefly, and one denied throughout is still reported.
  • Preserve both filenames and Windows error details when wrapping operating-system
    failures, and accept indexing-only command sequences supported by earlier callers.
  • Add run --from BRANCH_POINT_ID --reason TEXT -- COMMAND and Python
    run(..., source_branch_point_id=ID, reason=TEXT) to create and execute a
    variation in one call. Parameters override the new child pathway's inherited
    labels; labels declared only on the source run are not copied. Existing run
    results, defaults, and the separate branch/run --pathway workflow remain unchanged. Input
    is checked before the child is created. A later storage or execution failure can
    leave the child in place; structured errors retain known child and source IDs for
    inspection and explicit continuation without automatic retries.
  • Record a stop request arriving between process-polling timeouts as an interrupted
    run, stopping the command and retaining its evidence through the existing result
    interface.
  • Add canonical public names Ledger, RunRecord, and BranchPoint; retain
    Pathway and the legacy Den, Atom, and Chokepoint class aliases. Add
    descriptive result properties, Store readers, source keywords, and the
    branch-points CLI alias and --run storage selector. Existing constructor
    fields, success JSON, schema-2 records, IDs, checksums, and retained manifests
    remain compatible.
  • Add opt-in --json-errors for JSON results and structured failures, including
    argument errors, stable error categories, known run IDs, execution state, and
    recovery guidance. Existing --json behavior and exit statuses remain unchanged.
    logs still prints log bytes. Python StoreError exposes diagnostic fields too;
    run() errors that were ValidationError or OSError still are. A failure after launch directs
    callers to inspect retained attempts and runs before considering resubmission.
  • Add an executable history inspection example for a fresh caller with only a
    ledger root. It includes failed retries, empty variations, unfinished attempts,
    and verified bounded log excerpts with original-content references. It never
    executes or recovers a workload. Update terminology and migration guidance.
  • Fixed: validating a pathway no longer doubles its work for every branch
    generation. A history built by branching each run from the previous one made
    run, branch, compare, and verify take seconds after about ten generations
    and far longer after that. Each record is now validated once per operation.
  • ocura-oss --version prints the installed version.
  • pathways and compare read the atom records once per command, instead of
    once for every pathway or child pathway.
  • Add ocura-oss runs and Store.list_runs(): finalized runs ordered by terminal
    record timestamp and ID, including failed retries, each with the chokepoint_id
    to branch from.
    Filter by pathway or outcome, page with --limit and --after, or list every
    match with --all. Each page counts the runs still unfinished, which can finish
    behind its cursor; a walk whose pages count none lists every finished run.
  • Add ocura-oss show and Store.inspect_run(): one run with its pathway, terminal
    chokepoint, and the pathways branched from it. Command arguments are included
    only with --command. Neither command reads log contents.
  • Add --archive to the commands that only read, and Store(root, archive=True),
    to read a stable copy of a ledger without creating lock files. Archive mode
    refuses every change, and refuses a ledger with unfinished attempts, saying how
    to list and recover them.
  • Add ocura-oss logs, Store.open_verified_log(), and Store.log_info(): a
    run's verified original log bytes, --offset/--length excerpts, and storage
    metadata with --info or --json.
  • Add opt-in lossless log compression. run --compress (or --compress-min-bytes N)
    stores a run's captured logs of at least 1 MiB as gzip once it finishes, when that
    saves at least 10%; compress and decompress convert finalized logs, and
    --dry-run previews either. Logs stay raw by default. Records, IDs, digests, and
    retained manifests do not change, and every reader returns the original bytes.
    run and show print each log's current file, reported as log_files in JSON
    and by Store.log_files(), so standard gzip tools can open compressed logs.
    Ocura OSS 0.6 cannot read compressed logs: run decompress and verify before
    opening the ledger with it.
  • Keep completed run results available when optional compression or log-path
    reporting fails. Interrupted compression reports a storage warning and leaves
    finalized evidence intact. Refused locks fail promptly for writes; verified
    reads can fall back to unlocked access where locks are unavailable.
  • Support linked log directories when reporting storage paths, classify conversion
    failures by their underlying cause, and stop log output quietly when its reader
    closes the pipe.