sessionmemory 0.4.1__tar.gz → 0.5.0__tar.gz

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: sessionmemory
-Version: 0.4.1
+Version: 0.5.0
 Summary: Durable memory for coding agents, one folder of searchable pages per project.
 Author: Nathaniel Landau
 Author-email: Nathaniel Landau <github@natelandau.com>
@@ -205,7 +205,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/`, `plans/`, and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/` 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>"`
@@ -220,8 +220,11 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     which creates the file or heading when missing. Delete a finished line, and one
     that will never be done, directly; never tick or annotate it. Git history is the
     record of what was finished.
-  - Specs and plans: `sessionmemory new spec|plan --title "..." --cwd .` creates the file
-    and prints its path. Edit it directly after that.
+  - Specs: `specs/` holds one design record per feature, named `<date>-<topic>.md`
+    and kept after the work ships. Before designing or changing a feature, list the
+    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.
   - 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
@@ -237,8 +240,7 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
 ## Open work
 
   2 open backlog items
-  spec: Export invoices as UBL 2.1 XML
-  plan: Move PDF rendering to a worker queue
+  1 spec in specs/
 ```
 
 A page body never enters that block, so its cost grows with the number of pages and not

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/README.md

@@ -190,7 +190,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/`, `plans/`, and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/` 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>"`
@@ -205,8 +205,11 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     which creates the file or heading when missing. Delete a finished line, and one
     that will never be done, directly; never tick or annotate it. Git history is the
     record of what was finished.
-  - Specs and plans: `sessionmemory new spec|plan --title "..." --cwd .` creates the file
-    and prints its path. Edit it directly after that.
+  - Specs: `specs/` holds one design record per feature, named `<date>-<topic>.md`
+    and kept after the work ships. Before designing or changing a feature, list the
+    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.
   - 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
@@ -222,8 +225,7 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
 ## Open work
 
   2 open backlog items
-  spec: Export invoices as UBL 2.1 XML
-  plan: Move PDF rendering to a worker queue
+  1 spec in specs/
 ```
 
 A page body never enters that block, so its cost grows with the number of pages and not

{sessionmemory-0.4.1 → sessionmemory-0.5.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.4.1"
+version = "0.5.0"
 
 [[project.authors]]
 name = "Nathaniel Landau"

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/pyproject.toml.orig

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

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/src/sessionmemory/cli.py

@@ -65,7 +65,7 @@ app.command("log", help="Record this session's work in one upserted page.")(
 app.command("project", help="Report this directory's project, or register it.")(
     project.project_command
 )
-app.command("reindex", help="Rebuild this project's search indexes.")(
+app.command("reindex", help="Rebuild this project's search indexes, or every project's.")(
     reindex_commands.reindex_command
 )
 app.command("search", help="Search this project's learnings by meaning, or its logs with --logs.")(

sessionmemory-0.5.0/src/sessionmemory/commands/reindex.py

@@ -0,0 +1,67 @@
+"""The `reindex` command: rebuild a project's field indexes from its pages."""
+
+from __future__ import annotations
+
+from dataclasses import asdict
+from pathlib import Path  # noqa: TC003
+
+import typer
+from nclutils import pp
+
+from sessionmemory.commands._common import (
+    build_embedder,
+    emit_json,
+    fail,
+    require_project,
+    require_vault,
+)
+from sessionmemory.lib import fieldindex, paths
+
+CWD = typer.Option(None, "--cwd", help="Directory to resolve the project from.")
+ALL = typer.Option(False, "--all", help="Reindex every project in the vault.")  # noqa: FBT003
+JSON = typer.Option(False, "--json", help="Emit JSON instead of prose.")  # noqa: FBT003
+
+
+def reindex_command(
+    cwd: Path | None = CWD, *, all_projects: bool = ALL, as_json: bool = JSON
+) -> None:
+    """Bring this project's learnings and logs indexes up to date, or every project's.
+
+    Raises:
+        Exit: When `--all` is combined with `--cwd`.
+    """
+    vault = require_vault()
+    if all_projects:
+        if cwd is not None:
+            fail("--all and --cwd are mutually exclusive", ["pass one or the other"])
+        fields = [
+            (directory.parent.name, directory.name, directory)
+            for directory in paths.iter_field_dirs(vault)
+        ]
+    else:
+        slug = require_project(vault, cwd)
+        fields = [
+            (slug, paths.LEARNINGS_DIR, paths.learnings_dir(vault, slug)),
+            (slug, paths.LOGS_DIR, paths.logs_dir(vault, slug)),
+        ]
+    embedder = build_embedder()
+
+    if as_json:
+        payload: dict[str, dict] = {}
+        for slug, name, directory in fields:
+            counts = asdict(fieldindex.refresh(directory, embedder))
+            if all_projects:
+                payload.setdefault(slug, {})[name] = counts
+            else:
+                payload[name] = counts
+        emit_json(payload)
+        return
+
+    with pp.step("reindexing") as step:
+        for slug, name, directory in fields:
+            result = fieldindex.refresh(directory, embedder)
+            label = f"{slug}/{name}" if all_projects else name
+            step.sub(
+                f"{label}: {result.added} added, {result.updated} updated, "
+                f"{result.removed} removed, {result.unchanged} unchanged"
+            )

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/src/sessionmemory/lib/doctor.py

@@ -36,20 +36,11 @@ class Finding:
     message: str
 
 
-def _fields(vault: Path) -> list[Path]:
-    return [
-        paths.project_dir(vault, slug) / name
-        for slug in paths.iter_project_slugs(vault)
-        for name in paths.FIELD_DIRS
-        if (paths.project_dir(vault, slug) / name).is_dir()
-    ]
-
-
 def nonconformant_names(vault: Path, _embedder: Embedder) -> list[Finding]:
     """Report a markdown file in a field whose name breaks the spec's filename rule."""
     return [
         Finding("filename", str(path), "not lowercase ascii letters, digits, and hyphens")
-        for directory in _fields(vault)
+        for directory in paths.iter_field_dirs(vault)
         for path in sorted(directory.glob("*.md"))
         if path.is_file() and not field.is_debris(path.name) and not field.is_page_name(path.name)
     ]
@@ -63,7 +54,7 @@ def oversized_pages(vault: Path, _embedder: Embedder) -> list[Finding]:
             str(path),
             f"{path.stat().st_size} bytes; split it, the limit is {field.PAGE_LIMIT}",
         )
-        for directory in _fields(vault)
+        for directory in paths.iter_field_dirs(vault)
         for path in field.iter_pages(directory)
         if path.stat().st_size > field.PAGE_LIMIT
     ]
@@ -82,7 +73,7 @@ def malformed_frontmatter(vault: Path, _embedder: Embedder) -> list[Finding]:
     when it has no block at all.
     """
     findings = []
-    for directory in _fields(vault):
+    for directory in paths.iter_field_dirs(vault):
         for path in field.iter_pages(directory):
             raw = path.read_bytes()
             try:
@@ -114,7 +105,7 @@ def unquoted_datetimes(vault: Path, _embedder: Embedder) -> list[Finding]:
     block that cannot be parsed at all is left to the frontmatter check.
     """
     findings = []
-    for directory in _fields(vault):
+    for directory in paths.iter_field_dirs(vault):
         for path in field.iter_pages(directory):
             try:
                 keys = unquoted_datetime_keys(path.read_text(encoding="utf-8"))
@@ -191,7 +182,7 @@ def _is_stale(directory: Path, embedder: Embedder) -> str | None:
 def stale_indexes(vault: Path, embedder: Embedder) -> list[Finding]:
     """Report a field whose index file is unreadable or behind its pages."""
     findings = []
-    for directory in _fields(vault):
+    for directory in paths.iter_field_dirs(vault):
         message = _is_stale(directory, embedder)
         if message:
             findings.append(Finding("index", str(directory), message))

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/src/sessionmemory/lib/inject.py

@@ -25,8 +25,7 @@ class Injection:
     project: str
     titles: tuple[str, ...]
     open_backlog: int
-    specs: tuple[str, ...]
-    plans: tuple[str, ...]
+    specs: int
 
 
 def _sort_key(title: str) -> str:
@@ -45,14 +44,22 @@ def _open_backlog(path: Path) -> int:
     return sum(1 for line in path.read_text(encoding="utf-8").splitlines() if backlog.is_item(line))
 
 
+def _spec_count(directory: Path) -> int:
+    return sum(1 for _ in field.iter_pages(directory))
+
+
 def build(vault: Path, slug: str) -> Injection:
-    """Read the project's pages and files; the index is never consulted here."""
+    """Read the project's pages and files; the index is never consulted here.
+
+    Specs are counted rather than listed. A spec outlives the work it describes, so a
+    list of them is a changelog rather than open work, and it grows without bound. The
+    count says whether listing `specs/` is worth a call, which is all a session needs.
+    """
     return Injection(
         project=slug,
         titles=_titles(paths.learnings_dir(vault, slug)),
         open_backlog=_open_backlog(paths.backlog_path(vault, slug)),
-        specs=_titles(paths.specs_dir(vault, slug)),
-        plans=_titles(paths.plans_dir(vault, slug)),
+        specs=_spec_count(paths.specs_dir(vault, slug)),
     )
 
 
@@ -61,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/`, `plans/`, and `backlog.md`, which are ordinary files you Read and Edit.
+`specs/` 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>"`
@@ -76,8 +83,11 @@ away. The project's folder has `learnings/` and `logs/`, searched by meaning, be
     which creates the file or heading when missing. Delete a finished line, and one
     that will never be done, directly; never tick or annotate it. Git history is the
     record of what was finished.
-  - Specs and plans: `{command} new spec|plan --title "..." --cwd .` creates the file
-    and prints its path. Edit it directly after that.
+  - Specs: `specs/` holds one design record per feature, named `<date>-<topic>.md`
+    and kept after the work ships. Before designing or changing a feature, list the
+    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.
   - 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
@@ -93,8 +103,8 @@ def render(injection: Injection, *, command: str = "sessionmemory") -> str:
     lines.extend(["", "## Open work", ""])
     item = "item" if injection.open_backlog == 1 else "items"
     lines.append(f"  {injection.open_backlog} open backlog {item}")
-    lines.extend(f"  spec: {title}" for title in injection.specs)
-    lines.extend(f"  plan: {title}" for title in injection.plans)
+    spec = "spec" if injection.specs == 1 else "specs"
+    lines.append(f"  {injection.specs} {spec} in specs/")
     return "\n".join(lines)
 
 
@@ -105,6 +115,5 @@ def payload(injection: Injection, *, command: str) -> dict[str, object]:
         "project": injection.project,
         "titles": list(injection.titles),
         "open_backlog": injection.open_backlog,
-        "specs": list(injection.specs),
-        "plans": list(injection.plans),
+        "specs": injection.specs,
     }

{sessionmemory-0.4.1 → sessionmemory-0.5.0}/src/sessionmemory/lib/paths.py

@@ -75,3 +75,13 @@ def iter_project_slugs(vault: Path) -> list[str]:
     if not root.is_dir():
         return []
     return sorted(entry.name for entry in root.iterdir() if entry.is_dir())
+
+
+def iter_field_dirs(vault: Path) -> list[Path]:
+    """Return every existing field directory in the vault, sorted by project then field."""
+    return [
+        project_dir(vault, slug) / name
+        for slug in iter_project_slugs(vault)
+        for name in FIELD_DIRS
+        if (project_dir(vault, slug) / name).is_dir()
+    ]

sessionmemory-0.4.1/src/sessionmemory/commands/reindex.py

@@ -1,46 +0,0 @@
-"""The `reindex` command: rebuild a project's field indexes from its pages."""
-
-from __future__ import annotations
-
-from dataclasses import asdict
-from pathlib import Path  # noqa: TC003
-
-import typer
-from nclutils import pp
-
-from sessionmemory.commands._common import (
-    build_embedder,
-    emit_json,
-    require_project,
-    require_vault,
-)
-from sessionmemory.lib import fieldindex, paths
-
-CWD = typer.Option(None, "--cwd", help="Directory to resolve the project from.")
-JSON = typer.Option(False, "--json", help="Emit JSON instead of prose.")  # noqa: FBT003
-
-
-def reindex_command(cwd: Path | None = CWD, *, as_json: bool = JSON) -> None:
-    """Bring this project's learnings and logs indexes up to date."""
-    vault = require_vault()
-    slug = require_project(vault, cwd)
-    embedder = build_embedder()
-    fields = {
-        "learnings": paths.learnings_dir(vault, slug),
-        "logs": paths.logs_dir(vault, slug),
-    }
-    if as_json:
-        emit_json(
-            {
-                name: asdict(fieldindex.refresh(directory, embedder))
-                for name, directory in fields.items()
-            }
-        )
-        return
-    with pp.step("reindexing") as step:
-        for name, directory in fields.items():
-            result = fieldindex.refresh(directory, embedder)
-            step.sub(
-                f"{name}: {result.added} added, {result.updated} updated, "
-                f"{result.removed} removed, {result.unchanged} unchanged"
-            )