Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
58 changes: 58 additions & 0 deletions .meta/REQUIRED-FILES.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
== Required Repository Files

The following files *MUST* be present and kept up-to-date in every
repository:

=== Mandatory Dotfiles

[cols=",",options="header",]
|===
|File |Purpose
|`+.gitignore+` |Exclude build artifacts, secrets, and temp files
|`+.gitattributes+` |Enforce LF line endings and diff settings
|`+.editorconfig+` |Consistent editor settings across IDEs
|`+.tool-versions+` |asdf version pinning for reproducible builds
|===

=== Mandatory SCM Files

[cols=",",options="header",]
|===
|File |Purpose
|`+META.scm+` |Architecture decisions, development practices
|`+STATE.scm+` |Project state, phase, milestones
|`+ECOSYSTEM.scm+` |Ecosystem positioning, related projects
|`+PLAYBOOK.scm+` |Executable plans, procedures
|`+AGENTIC.scm+` |AI agent operational gating
|`+NEUROSYM.scm+` |Symbolic semantics, proof obligations
|===

=== Build System

[cols=",",options="header",]
|===
|File |Purpose
|`+justfile+` |Task runner (replaces Makefile)
|`+Mustfile+` |Deployment state contract
|===

*IMPORTANT*: Makefiles are FORBIDDEN. Use `+just+` for all tasks.

=== Validation

These files are checked by: - CI workflow validation - Pre-commit hooks
(when configured) - Repository standardization scripts

=== Updates

When updating these files: 1. Use templates from `+rsr-template-repo+`
as reference 2. Ensure SPDX license header is present 3. Test changes
locally before pushing 4. Keep language-specific sections relevant to
the repo

=== See Also

* https://github.com/hyperpolymath/rhodium-standard-repositories[RSR
(Rhodium Standard Repositories)]
* https://github.com/hyperpolymath/mustfile[Mustfile Specification]
* https://github.com/hyperpolymath/meta-scm[SCM Format Family]
53 changes: 0 additions & 53 deletions .meta/REQUIRED-FILES.md

This file was deleted.

42 changes: 42 additions & 0 deletions .session/LAST-CANONICAL-COMMAND.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
== Last Canonical Session Command

* Command: close planned /var/mnt/eclipse/repos/ambientops
* Timestamp (UTC): 2026-04-12T22:45:00Z
* Repo path: /var/mnt/eclipse/repos/ambientops
* Protocol path: continuity/planned-session-close
* Standards dir:
/var/mnt/eclipse/repos/developer-ecosystem/standards/session-management-standards

=== Continuity Core (update while executing)

* Goal: Integrate miniKanren-style diagnostics + sophisticated A2ML
logging into AmbientOps Pulse, deploy safely, and stabilise crash-loop
observability.
* Current task: Planned session close capture completed.
* Last completed action: Pushed
`+feat(pulse): add miniKanren diagnostics and A2ML event log+` to
`+origin/main+` at commit `+5a66d9a+`.
* Next intended action: Resume at the 48h review reminder on 2026-04-14
23:53:06 BST, then run maintenance verification if stable.
* Repository: /var/mnt/eclipse/repos/ambientops
* Branch: main
* HEAD commit: 5a66d9a
* Files of interest: emergency-room/rust/src/pulse.rs,
emergency-room/rust/src/main.rs,
emergency-room/systemd/ambientops-pulse.service,
emergency-room/MIGRATION.adoc,
~/.local/share/ambientops/pulse/pulse-events.a2ml
* Known blockers: None for integration/deployment; environment-specific
shell doctor checks may report writability false outside service
context.
* Residual risks: A2ML event integrity marker currently uses siphash
(tamper-evident hint, not cryptographic signature); false-positive
crash-loop heuristics remain possible under transient pressure bursts.
* Recommended next protocol: verify maintenance
/var/mnt/eclipse/repos/ambientops

=== Close Status

* Planned close completed: 2026-04-12T22:58:02Z
* Session handback state: clean stop with continuity artifacts captured
in `+.session/+`
26 changes: 0 additions & 26 deletions .session/LAST-CANONICAL-COMMAND.md

This file was deleted.

21 changes: 21 additions & 0 deletions .session/NEXT_STEPS.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
== NEXT_STEPS

[arabic]
. Immediate next action: Watch
`+journalctl --user -u ambientops-pulse -f+` for one full
memory-pressure cycle.
. Follow-up action: Confirm A2ML envelope growth in
`+/home/hyper/.local/share/ambientops/pulse/pulse-events.a2ml+` under
both warning and recovery events.
. Validation action: Run
`+~/.local/bin/emergency-room pulse --doctor --state-path ~/.local/share/ambientops/pulse/state.json --a2ml-log-path ~/.local/share/ambientops/pulse/pulse-events.a2ml+`
in your normal desktop session.
. Handover/closure action: If stable, proceed with
`+verify maintenance /var/mnt/eclipse/repos/ambientops+`.
. Timed review action (48h): At `+2026-04-14 23:53:06 BST+`, verify
reminder execution with
`+systemctl --user status ambientops-pulse-48h-review.service --no-pager+`,
then rerun
`+journalctl --user -u ambientops-pulse --since '48 hours ago' --no-pager+`
and review
`+/home/hyper/.local/share/ambientops/pulse/pulse-events.a2ml+`.
7 changes: 0 additions & 7 deletions .session/NEXT_STEPS.md

This file was deleted.

26 changes: 26 additions & 0 deletions .session/SESSION_STATE.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
== SESSION_STATE

* Goal: Integrate miniKanren-style diagnostics + sophisticated A2ML
logging into AmbientOps Pulse and deploy safely.
* Current task: Closed (planned-session-close complete).
* Last completed action: Implemented, tested, deployed, and pushed Pulse
integration (`+5a66d9a+`).
* Next intended action: Re-open at the 48h timer checkpoint
(`+2026-04-14 23:53:06 BST+`) and run maintenance verification when
convenient.
* Repository: /var/mnt/eclipse/repos/ambientops
* Branch: main
* HEAD commit: 5a66d9a
* Files of interest:
** emergency-room/rust/src/pulse.rs
** emergency-room/rust/src/main.rs
** emergency-room/systemd/ambientops-pulse.service
** emergency-room/MIGRATION.adoc
** /home/hyper/.local/share/ambientops/pulse/pulse-events.a2ml
* Known blockers:
** none
* Residual risks:
** siphash integrity marker is not a cryptographic signature
** heuristic crash-loop inference may occasionally over-warn
* Recommended next protocol: verify maintenance
/var/mnt/eclipse/repos/ambientops
21 changes: 0 additions & 21 deletions .session/SESSION_STATE.md

This file was deleted.

50 changes: 50 additions & 0 deletions .session/SESSION_SUMMARY.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
== SESSION_SUMMARY

=== Outcome

Pulse now has integrated miniKanren-style diagnostic reasoning and
append-only A2ML event envelopes in one runtime path.

=== What Was Completed

* Added miniKanren-like inference engine in `+pulse.rs+` to infer
stability/memory/telemetry guidance.
* Added integrated A2ML event logging with envelope + payload +
integrity marker.
* Extended CLI with `+--a2ml-log-path+` and default auto-path
derivation.
* Updated systemd unit to pass `+--a2ml-log-path+` explicitly.
* Updated migration docs.
* Ran `+cargo test -p emergency-room+` (all tests passed).
* Deployed service and verified active ExecStart includes new argument.
* Verified live A2ML log file creation and event write.

=== What Is Pending

* Longer soak monitoring for false-positive rate and notification
quality.
* Optional future upgrade from siphash integrity hint to cryptographic
signature/hash chain.

=== Continuity Core

* Goal: Integrate miniKanren-style diagnostics + sophisticated A2ML
logging into AmbientOps Pulse and deploy safely.
* Current task: Session closure and continuity capture.
* Last completed action: Commit `+5a66d9a+` pushed to `+origin/main+`.
* Next intended action: Observe runtime stability and run maintenance
verification if desired.
* Repository: /var/mnt/eclipse/repos/ambientops
* Branch: main
* HEAD commit: 5a66d9a
* Files of interest:
** emergency-room/rust/src/pulse.rs
** emergency-room/rust/src/main.rs
** emergency-room/systemd/ambientops-pulse.service
** emergency-room/MIGRATION.adoc
** /home/hyper/.local/share/ambientops/pulse/pulse-events.a2ml
* Known blockers: none
* Residual risks: heuristic over-warning under transient pressure;
non-cryptographic integrity marker.
* Recommended next protocol: verify maintenance
/var/mnt/eclipse/repos/ambientops
37 changes: 0 additions & 37 deletions .session/SESSION_SUMMARY.md

This file was deleted.

Loading