Skip to content

Document lifecycle-aware continuity controls in README#125

Open
samrusani wants to merge 136 commits intomainfrom
codex/readme-lifecycle-controls
Open

Document lifecycle-aware continuity controls in README#125
samrusani wants to merge 136 commits intomainfrom
codex/readme-lifecycle-controls

Conversation

@samrusani
Copy link
Copy Markdown
Owner

What changed

This updates the README to explain that continuity objects now track preservation, searchability, and promotability independently instead of treating lifecycle state as a single active flag.

It also adds the lifecycle-aware positioning to the feature lists and documents the CLI commands for inspecting lifecycle posture and resuming with non-promotable facts when that override is needed.

Why it changed

The lifecycle split already exists in the product, but the README did not explain the default recall and resumption filtering clearly enough for someone approaching the project from the outside.

Documenting the lifecycle model in the public README makes the behavior easier to understand and gives developers a direct path to the relevant CLI commands.

Impact

Developers reading the project overview and getting-started flow now see how preservation, recall visibility, and promotion eligibility differ, and they can discover the lifecycle inspection and resume override commands without reading the implementation first.

Testing

Not run. This is a README-only change.

samrusani and others added 30 commits March 13, 2026 23:24
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5H: semantic artifact chunk retrieval packet

* Sprint 5H: semantic artifact chunk retrieval primitive

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5I: compile semantic artifact retrieval packet

* Sprint 5I: compile semantic artifact retrieval adoption

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5J: hybrid artifact merge packet

* Sprint 5J: deterministic hybrid artifact merge

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5K: project truth sync packet

* Sprint 5K: project truth synchronization

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5L: PDF artifact parsing packet

* Sprint 5L: PDF artifact parsing v0

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5M: DOCX artifact parsing packet

* Sprint 5M: DOCX artifact parsing v0

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5N: RFC822 email artifact parsing packet

* Sprint 5N: RFC822 email artifact parsing v0

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5O: Gmail connection and single-message ingestion packet

* Sprint 5O: Gmail connection and single-message ingestion

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5P: Gmail credential hardening packet

* Sprint 5P: Gmail credential hardening

---------

Co-authored-by: Sami Rusani <sr@samirusani>
* Sprint 5Q: Gmail refresh token lifecycle packet

* Sprint 5Q: Gmail refresh token lifecycle

---------

Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
samrusani and others added 28 commits April 7, 2026 23:17
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
* Compaction 01: archive stale planning context

* Compaction 01: restore control packet metadata

---------

Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Sami Rusani <sr@samirusani>
Co-authored-by: Redacted User <redacted@users.noreply.github.com>
#114)

Co-authored-by: Redacted User <redacted@users.noreply.github.com>
Co-authored-by: Redacted User <redacted@users.noreply.github.com>
Co-authored-by: Redacted User <redacted@users.noreply.github.com>
Co-authored-by: Redacted User <redacted@users.noreply.github.com>
Implements trust classes, promotion eligibility, trust metadata, and trust-aware review behavior across memory admission, persistence, retrieval, explain/context output, and API contracts.
@samrusani samrusani force-pushed the main branch 2 times, most recently from f93cfb5 to b73fd46 Compare April 11, 2026 21:00
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.

2 participants