daimon-briefing 0.3.2__tar.gz → 0.3.3__tar.gz

{daimon_briefing-0.3.2 → daimon_briefing-0.3.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: daimon-briefing
-Version: 0.3.2
-Summary: Dream-briefing hermes plugin: cognitive checkpoint at session end, 'while you were away' briefing at session start. Slice 1 (local-file, no Honcho).
+Version: 0.3.3
+Summary: Dream-briefing for AI coding agents: writes a cognitive checkpoint at session end and shows a 'while you were away' briefing at session start. Self-contained, stdlib-only.
 Author: Daily-Nerd / Daimon
 License: Apache-2.0
 Requires-Python: >=3.10

{daimon_briefing-0.3.2 → daimon_briefing-0.3.3}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "daimon-briefing"
-version = "0.3.2"
-description = "Dream-briefing hermes plugin: cognitive checkpoint at session end, 'while you were away' briefing at session start. Slice 1 (local-file, no Honcho)."
+version = "0.3.3"
+description = "Dream-briefing for AI coding agents: writes a cognitive checkpoint at session end and shows a 'while you were away' briefing at session start. Self-contained, stdlib-only."
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "Apache-2.0" }

daimon_briefing-0.3.3/skills/daimon-briefing/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: daimon-briefing
+description: Dream-briefing — surfaces a "while you were away / here's where we left off" briefing at the start of a resumed session, reconstructed from a cognitive checkpoint written at the end of the prior session. Use to recall open loops, decisions, and facts whose state may have changed outside the AI session (e.g. a PR you merged yourself).
+---
+
+# Daimon Dream-Briefing
+
+This plugin keeps continuity across sessions. At the **end** of each session it
+serializes the transcript into a cognitive checkpoint (open loops, decisions,
+beliefs, with extractively-pinned verbatim quotes). At the **start** of the next
+session it injects a skimmable briefing so you resume from a faithful prior state
+instead of a confident guess.
+
+## What it surfaces, in order
+
+1. **Verify before trusting** — items whose state may have changed *outside* this
+   session (a PR you said you'd merge, a deploy, a file edited elsewhere). These come
+   first because they are the gap that produces confident-but-wrong assertions.
+2. **Open loops** — questions left unresolved at the end of last session.
+3. **Decisions made** — explicit choices, including assistant-side fixes/diagnoses.
+4. **Active topic / beliefs / uncertainties.**
+
+Each item is marked `✓ verbatim` (pinned to an exact quote — trust it) or
+`~ inferred` (paraphrased — treat with appropriate caution).
+
+## Automatic behavior
+
+You do not need to invoke anything. The plugin wires the host's native session
+hooks: a checkpoint is written automatically when a session **ends**, and the
+briefing appears automatically at the **start** of the next session if a prior
+checkpoint exists. Between those, a lightweight **proactive recall** watches your
+prompts and surfaces a one-line "you worked on this before" pointer when the
+current prompt overlaps a prior open loop — without re-suggesting anything the
+start-of-session briefing already carried.
+
+## Manual trigger
+
+To re-read the latest briefing on demand, run the bundled CLI:
+
+```bash
+daimon brief
+```
+
+## Configuration
+
+See the plugin README. Key knobs: `DAIMON_DISABLE=1` (kill switch),
+`DAIMON_CHECKPOINT_DIR`, `DAIMON_MIN_MESSAGES`, `DAIMON_LLM_*` (falling back to
+`LITELLM_*`), `DAIMON_LLM_BACKEND=command` + `DAIMON_LLM_COMMAND` (headless-CLI fallback).
+
+## What ships today
+
+Daimon is self-contained and host-agnostic — no server, no external memory
+backend, stdlib-only at runtime. The capabilities behind the briefing:
+
+- **Checkpoint → briefing loop.** Session end serializes the transcript into a
+  per-project JSON checkpoint; session start reconstructs it into the briefing.
+- **Chunked extraction.** Long transcripts are split into overlapping chunks,
+  serialized pass-by-pass, then merged — so recall holds up on long sessions
+  instead of degrading as the transcript grows.
+- **Deterministic carry.** Unresolved open loops that still matter are carried
+  forward into the next checkpoint by exact term overlap (no LLM in the carry
+  step) and marked `[carried]` so you can see a loop survived from an earlier
+  session rather than being freshly observed.
+- **Proactive recall.** A per-prompt pointer to prior work when your current
+  prompt overlaps an open loop (see *Automatic behavior*).
+- **Trust classing.** Every item is `✓ verbatim` (pinned to an exact quote) or
+  `~ inferred` (paraphrased), so you know what to trust literally.
+- **Code-drift detection.** `daimon anchor <file> <symbol>` binds a checkpoint
+  item to a code symbol; the briefing flags it under **CODE DRIFT — verify
+  before trusting** when that symbol's body changes or disappears (offline,
+  stdlib `ast`).
+- **Scars.** An optional session-end pass harvests negative-knowledge signals
+  (abandoned approaches, landmines) into the repo's `.scars/` directory.
+- **Status & self-heal.** `daimon status` reports checkpoint/briefing health;
+  a failed capture self-heals on the next session start.

daimon_briefing-0.3.2/skills/daimon-briefing/SKILL.md

@@ -1,49 +0,0 @@
----
-name: daimon-briefing
-description: Dream-briefing — surfaces a "while you were away / here's where we left off" briefing at the start of a resumed session, reconstructed from a cognitive checkpoint written at the end of the prior session. Use to recall open loops, decisions, and facts whose state may have changed outside the AI session (e.g. a PR you merged yourself).
----
-
-# Daimon Dream-Briefing
-
-This plugin keeps continuity across sessions. At the **end** of each session it
-serializes the transcript into a cognitive checkpoint (open loops, decisions,
-beliefs, with extractively-pinned verbatim quotes). At the **start** of the next
-session it injects a skimmable briefing so you resume from a faithful prior state
-instead of a confident guess.
-
-## What it surfaces, in order
-
-1. **Verify before trusting** — items whose state may have changed *outside* this
-   session (a PR you said you'd merge, a deploy, a file edited elsewhere). These come
-   first because they are the gap that produces confident-but-wrong assertions.
-2. **Open loops** — questions left unresolved at the end of last session.
-3. **Decisions made** — explicit choices, including assistant-side fixes/diagnoses.
-4. **Active topic / beliefs / uncertainties.**
-
-Each item is marked `✓ verbatim` (pinned to an exact quote — trust it) or
-`~ inferred` (paraphrased — treat with appropriate caution).
-
-## Automatic behavior
-
-You do not need to invoke anything. The briefing appears automatically on the first
-turn of a new session if a prior checkpoint exists. Checkpoints are written
-automatically when a session ends.
-
-## Manual trigger
-
-To re-read the latest briefing on demand, run the bundled CLI:
-
-```bash
-daimon brief
-```
-
-## Configuration
-
-See the plugin README. Key knobs: `DAIMON_DISABLE=1` (kill switch),
-`DAIMON_CHECKPOINT_DIR`, `DAIMON_MIN_MESSAGES`, `DAIMON_LLM_*` (falling back to
-`LITELLM_*`), `DAIMON_LLM_BACKEND=command` + `DAIMON_LLM_COMMAND` (headless-CLI fallback).
-
-## Scope (Slice 1)
-
-Local-file checkpoints, single-pass serialization, no Honcho. Long-transcript recall
-(chunking) is Slice 2; Honcho-backed cross-session recall is Slice 3.