truenex-memory 0.2.0__py3-none-any.whl

truenex_memory/__init__.py

@@ -0,0 +1,3 @@
+"""Truenex Memory - Local-first memory layer for coding agents."""
+
+__version__ = "0.2.0"

truenex_memory/adapters/__init__.py

@@ -0,0 +1,68 @@
+"""Agent instruction file generators."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+AGENTS_FILENAME = "AGENTS.md"
+CLAUDE_FILENAME = "CLAUDE.md"
+
+
+def render_agents_md(project_name: str = "Truenex Memory") -> str:
+    """Render an AGENTS.md file for local coding agents."""
+
+    return f"""# {project_name} Agent Notes
+
+- Keep memory data local by default.
+- Do not require cloud services for diagnostics, import, export, or local tools.
+- Prefer small, testable changes and avoid unrelated rewrites.
+- Run focused tests for touched surfaces before handing work back.
+"""
+
+
+def render_claude_md(project_name: str = "Truenex Memory") -> str:
+    """Render a CLAUDE.md file for Claude-style coding agents."""
+
+    return f"""# {project_name}
+
+Use this repository as a local-first memory layer for coding agents.
+
+## Working Rules
+
+- Keep generated memory artifacts in local files unless the user asks otherwise.
+- Treat MCP tools as local callable helpers during development.
+- Do not assume production cloud, licensing, or UI services are available.
+"""
+
+
+def write_agent_docs(
+    directory: str | Path,
+    *,
+    project_name: str = "Truenex Memory",
+    overwrite: bool = False,
+) -> dict[str, Path]:
+    """Write AGENTS.md and CLAUDE.md files into a directory."""
+
+    target = Path(directory)
+    target.mkdir(parents=True, exist_ok=True)
+    files = {
+        AGENTS_FILENAME: render_agents_md(project_name),
+        CLAUDE_FILENAME: render_claude_md(project_name),
+    }
+    written: dict[str, Path] = {}
+    for filename, content in files.items():
+        path = target / filename
+        if path.exists() and not overwrite:
+            raise FileExistsError(f"{path} already exists")
+        path.write_text(content, encoding="utf-8")
+        written[filename] = path
+    return written
+
+
+__all__ = [
+    "AGENTS_FILENAME",
+    "CLAUDE_FILENAME",
+    "render_agents_md",
+    "render_claude_md",
+    "write_agent_docs",
+]

truenex_memory/adapters/__main__.py

@@ -0,0 +1,29 @@
+"""Command-line entry point for agent adapter file generation."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated
+
+import typer
+
+from truenex_memory.adapters import write_agent_docs
+
+app = typer.Typer(help="Generate local agent adapter instruction files.")
+
+
+@app.command("generate")
+def generate(
+    directory: Annotated[Path, typer.Argument(help="Directory where files are written.")],
+    project_name: Annotated[str, typer.Option("--project-name")] = "Truenex Memory",
+    overwrite: Annotated[bool, typer.Option("--overwrite")] = False,
+) -> None:
+    """Generate AGENTS.md and CLAUDE.md."""
+
+    written = write_agent_docs(directory, project_name=project_name, overwrite=overwrite)
+    for name, path in written.items():
+        typer.echo(f"{name}: {path}")
+
+
+if __name__ == "__main__":
+    app()

truenex_memory/adapters/agents_md.py

@@ -0,0 +1,17 @@
+"""AGENTS.md adapter text generation."""
+
+from __future__ import annotations
+
+
+def generate_agents_md() -> str:
+    """Return concise instructions for agents using Truenex Memory."""
+
+    return "\n".join(
+        [
+            "# Agent Memory",
+            "",
+            "Before making project claims, query Truenex Memory for relevant constraints.",
+            "Use `memory_search` for decisions, architecture notes, and project conventions.",
+            "Cite local source paths returned by memory results when they affect the answer.",
+        ]
+    )

truenex_memory/adapters/claude_md.py

@@ -0,0 +1,17 @@
+"""CLAUDE.md adapter text generation."""
+
+from __future__ import annotations
+
+
+def generate_claude_md() -> str:
+    """Return concise Claude Code instructions for Truenex Memory."""
+
+    return "\n".join(
+        [
+            "# Truenex Memory",
+            "",
+            "Before coding, search local memory for project decisions and constraints.",
+            "Prefer active memory results and treat unverified results as tentative.",
+            "Do not use obsolete or superseded memory unless explicitly asked.",
+        ]
+    )