sessionmemory 0.6.1__tar.gz → 0.7.0__tar.gz

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sessionmemory
-Version: 0.6.1
+Version: 0.7.0
 Summary: Durable memory for coding agents, one folder of searchable pages per project.
 Author: Nathaniel Landau
 Author-email: Nathaniel Landau <github@natelandau.com>
@@ -202,7 +202,7 @@ project holding four learnings, one spec, one plan, and two open backlog items:
 Durable memory for this project lives in a vault of markdown pages. Nothing below is
 loaded for you: the titles are what the vault holds, and each is one `sessionmemory search`
 away. The project's folder has `learnings/` and `logs/`, searched by meaning, beside
-`specs/` and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/`, `runbooks/`, and `backlog.md`, which are ordinary files you Read and Edit.
 `sessionmemory project --json` prints every path.
 
   - Before assuming nothing was written down, search: `sessionmemory search "<words>"`
@@ -225,6 +225,10 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     directory and read any spec whose name matches, so a decision already made is not
     made again. `sessionmemory new spec --title "..." --cwd .` creates one and prints its
     path. Edit it directly after that.
+  - Runbooks: `runbooks/` holds step-by-step procedures to follow by hand, such as
+    configuring a service, rotating a credential, or recovering from an outage.
+    Whenever you write one, create it with `sessionmemory new runbook --title "..." --cwd .`,
+    which prints its path, never in another folder or the repository.
   - Learnings are captured at session end, not by you mid-session. When the user asks
     to keep one now: `sessionmemory new learning --title "..." --summary "..." --cwd .`
     creates the page and prints the path to write prose into. Title and summary state

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/README.md

@@ -187,7 +187,7 @@ project holding four learnings, one spec, one plan, and two open backlog items:
 Durable memory for this project lives in a vault of markdown pages. Nothing below is
 loaded for you: the titles are what the vault holds, and each is one `sessionmemory search`
 away. The project's folder has `learnings/` and `logs/`, searched by meaning, beside
-`specs/` and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/`, `runbooks/`, and `backlog.md`, which are ordinary files you Read and Edit.
 `sessionmemory project --json` prints every path.
 
   - Before assuming nothing was written down, search: `sessionmemory search "<words>"`
@@ -210,6 +210,10 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     directory and read any spec whose name matches, so a decision already made is not
     made again. `sessionmemory new spec --title "..." --cwd .` creates one and prints its
     path. Edit it directly after that.
+  - Runbooks: `runbooks/` holds step-by-step procedures to follow by hand, such as
+    configuring a service, rotating a credential, or recovering from an outage.
+    Whenever you write one, create it with `sessionmemory new runbook --title "..." --cwd .`,
+    which prints its path, never in another folder or the repository.
   - Learnings are captured at session end, not by you mid-session. When the user asks
     to keep one now: `sessionmemory new learning --title "..." --summary "..." --cwd .`
     creates the page and prints the path to write prose into. Title and summary state

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/pyproject.toml

@@ -11,7 +11,7 @@ description = "Durable memory for coding agents, one folder of searchable pages
 name = "sessionmemory"
 readme = "README.md"
 requires-python = ">=3.13,<3.15"
-version = "0.6.1"
+version = "0.7.0"
 
 [[project.authors]]
 name = "Nathaniel Landau"

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/pyproject.toml.orig

@@ -12,7 +12,7 @@
     name = "sessionmemory"
     readme = "README.md"
     requires-python = ">=3.13,<3.15"
-    version = "0.6.1"
+    version = "0.7.0"
 
     [project.scripts]
         sessionmemory = "sessionmemory.cli:main"

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/src/sessionmemory/commands/new.py

@@ -18,7 +18,9 @@ from sessionmemory.commands._common import (
 from sessionmemory.lib import backlog, field, paths
 from sessionmemory.lib.config import now, today
 
-app = typer.Typer(no_args_is_help=True, help="Create a learning, spec, plan, or backlog item.")
+app = typer.Typer(
+    no_args_is_help=True, help="Create a learning, spec, plan, runbook, or backlog item."
+)
 
 # Typer lists an Enum's members in --help and rejects anything else at parse time, so the
 # allowed sets are spelled once, in lib/backlog, and mirrored here as choices.
@@ -112,6 +114,23 @@ def new_plan(
     )
 
 
+@app.command("runbook")
+def new_runbook(
+    title: str = TITLE,
+    body: str = BODY,
+    body_file: Path | None = BODY_FILE,
+    cwd: Path | None = CWD,
+    *,
+    as_json: bool = JSON,
+) -> None:
+    """Create a runbook for this project."""
+    vault = require_vault()
+    slug = require_project(vault, cwd)
+    _new_document(
+        paths.runbooks_dir(vault, slug), title, resolve_body(body, body_file), as_json=as_json
+    )
+
+
 @app.command("backlog", help="Add one open item to this project's backlog.md.")
 def new_backlog(
     kind: Kind = KIND,

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/src/sessionmemory/lib/bootstrap.py

@@ -46,7 +46,7 @@ One folder per project under `projects/`. Inside each:
 
 - `learnings/` is a field: flat markdown pages, embedded and searchable.
 - `logs/` is a second field, one page per session, searched on request.
-- `specs/`, `plans/`, and `backlog.md` are plain files, never indexed.
+- `specs/`, `plans/`, `runbooks/`, and `backlog.md` are plain files, never indexed.
 - `backlog.md` is the list of open items for the project, one line each, sized by
   effort and grouped by commit type.
 

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/src/sessionmemory/lib/inject.py

@@ -68,7 +68,7 @@ GUIDANCE = """## Using this vault
 Durable memory for this project lives in a vault of markdown pages. Nothing below is
 loaded for you: the titles are what the vault holds, and each is one `{command} search`
 away. The project's folder has `learnings/` and `logs/`, searched by meaning, beside
-`specs/` and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/`, `runbooks/`, and `backlog.md`, which are ordinary files you Read and Edit.
 `{command} project --json` prints every path.
 
   - Before assuming nothing was written down, search: `{command} search "<words>"`
@@ -91,6 +91,10 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     directory and read any spec whose name matches, so a decision already made is not
     made again. `{command} new spec --title "..." --cwd .` creates one and prints its
     path. Edit it directly after that.
+  - Runbooks: `runbooks/` holds step-by-step procedures to follow by hand, such as
+    configuring a service, rotating a credential, or recovering from an outage.
+    Whenever you write one, create it with `{command} new runbook --title "..." --cwd .`,
+    which prints its path, never in another folder or the repository.
   - Learnings are captured at session end, not by you mid-session. When the user asks
     to keep one now: `{command} new learning --title "..." --summary "..." --cwd .`
     creates the page and prints the path to write prose into. Title and summary state

{sessionmemory-0.6.1 → sessionmemory-0.7.0}/src/sessionmemory/lib/paths.py

@@ -1,7 +1,8 @@
 """Where a project's files live inside the vault.
 
 `learnings/` and `logs/` are fields: flat directories of pages, each with its own
-index. `specs/`, `plans/`, and `backlog.md` sit beside them and are never indexed. A
+index. `specs/`, `plans/`, `runbooks/`, and `backlog.md` sit beside them and are never
+indexed. A
 project's files are found by its slug and nothing else; there is no global scope.
 """
 
@@ -19,6 +20,7 @@ LEARNINGS_DIR = "learnings"
 LOGS_DIR = "logs"
 SPECS_DIR = "specs"
 PLANS_DIR = "plans"
+RUNBOOKS_DIR = "runbooks"
 BACKLOG_FILE = "backlog.md"
 
 FIELD_DIRS: tuple[str, ...] = (LEARNINGS_DIR, LOGS_DIR)
@@ -49,6 +51,11 @@ def plans_dir(vault: Path, slug: str) -> Path:
     return project_dir(vault, slug) / PLANS_DIR
 
 
+def runbooks_dir(vault: Path, slug: str) -> Path:
+    """Return the project's runbooks folder."""
+    return project_dir(vault, slug) / RUNBOOKS_DIR
+
+
 def backlog_path(vault: Path, slug: str) -> Path:
     """Return the project's backlog checklist file."""
     return project_dir(vault, slug) / BACKLOG_FILE
@@ -65,6 +72,7 @@ def project_paths(vault: Path, slug: str) -> dict[str, str]:
         "logs": str(logs_dir(vault, slug)),
         "specs": str(specs_dir(vault, slug)),
         "plans": str(plans_dir(vault, slug)),
+        "runbooks": str(runbooks_dir(vault, slug)),
         "backlog": str(backlog_path(vault, slug)),
     }