Skip to content

docs(cli): add the item fields a working copy writes and queries - #631

Merged
aicayzer merged 2 commits into
mainfrom
docs/copy-item-fields
Oct 25, 2026
Merged

aicayzer merged 2 commits into
mainfrom
docs/copy-item-fields

Conversation

@aicayzer

@aicayzer aicayzer commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Documents the item fields a working copy now writes and queries, as marfa device items create, update, list and marfa device search take them (withmarfa/marfa#2401).

Changes

  • reference/cli: a new section lists the create, edit, list and search options, how a create with edges is one write, and the sort and change-time rules.
  • The section also says that --sort updated-at or --direction asc alone is taken beside --updated-after, that an edge an answer leaves out of a cut block stays shown until the next catch-up, that a refusal before queueing carries the instance's error code, and what a clear of the own time shows while the create waits.

Testing

  • pnpm test: 699 of 700 pass. command-check fails by design on the new options (--capture-longitude, --clear-occurred-at and the others) until the marfa pull request merges and the sync script writes its command tree here. I did not run the sync script.

Notes for reviewers

Checklist

  • The title is a scoped Conventional Commit.
  • Docs, comments and the contract still say what is true after this change.

@aicayzer
aicayzer marked this pull request as ready for review October 25, 2026 12:37
@aicayzer
aicayzer force-pushed the docs/copy-item-fields branch from 18f9ec1 to 1a31ac9 Compare October 25, 2026 12:37
@aicayzer

Copy link
Copy Markdown
Contributor Author

Rebased onto main after #633 and the v0.0.36 sync (#635). Review depth: checks only; a small docs change describing merged behavior, checked against the v0.0.36 tag.

@aicayzer
aicayzer merged commit 45626f6 into main Oct 25, 2026
3 checks passed
@aicayzer
aicayzer deleted the docs/copy-item-fields branch October 25, 2026 12:40
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