remem-ai 0.6.93

Local-first coding agent memory for Claude Code and OpenAI Codex
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

import tempfile
import unittest
from pathlib import Path

import check_documentation_contracts


def handoff_index(row: str) -> str:
    return (
        "### Current/Historical GH Packet Handoffs\n\n"
        "| Contract | Canonical current packet | Historical packet |\n"
        "|---|---|---|\n"
        f"{row}\n"
    )


class CurrentSpecHandoffContractTests(unittest.TestCase):
    def fixture_root(
        self, *, include_current: bool = True, include_historical: bool = True
    ) -> Path:
        temp_dir = tempfile.TemporaryDirectory()
        self.addCleanup(temp_dir.cleanup)
        root = Path(temp_dir.name)
        (root / "docs/specs").mkdir(parents=True)
        if include_current:
            (root / "docs/specs/GH931").mkdir()
        if include_historical:
            (root / "specs/GH931").mkdir(parents=True)
        return root

    def test_accepts_explicit_historical_packet(self) -> None:
        root = self.fixture_root()
        (root / "docs/specs/README.md").write_text(
            handoff_index(
                "| `GH931` | `docs/specs/GH931/` | `specs/GH931/` |"
            ),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertEqual(violations, [])

    def test_rejects_unlabelled_duplicate_tree(self) -> None:
        root = self.fixture_root()
        (root / "docs/specs/README.md").write_text(
            handoff_index(""),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertTrue(
            any(
                "overlapping GH931 packets require a structured handoff row" in item
                for item in violations
            )
        )

    def test_rejects_mismatched_current_path(self) -> None:
        root = self.fixture_root()
        (root / "docs/specs/README.md").write_text(
            handoff_index(
                "| `GH931` | `docs/specs/GH932/` | `specs/GH931/` |"
            ),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertTrue(any("must declare exact" in item for item in violations))

    def test_rejects_extra_handoff_column(self) -> None:
        root = self.fixture_root()
        (root / "docs/specs/README.md").write_text(
            handoff_index(
                "| `GH931` | `docs/specs/GH931/` | `specs/GH931/` | canonical |"
            ),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertTrue(any("must declare exact" in item for item in violations))

    def test_rejects_declared_missing_historical_packet(self) -> None:
        root = self.fixture_root(include_historical=False)
        (root / "docs/specs/README.md").write_text(
            handoff_index(
                "| `GH931` | `docs/specs/GH931/` | `specs/GH931/` |"
            ),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertIn(
            "docs/specs/README.md: declared historical packet `specs/GH931/` is missing",
            violations,
        )

    def test_rejects_declared_missing_current_packet(self) -> None:
        root = self.fixture_root(include_current=False)
        (root / "docs/specs/README.md").write_text(
            handoff_index(
                "| `GH931` | `docs/specs/GH931/` | `specs/GH931/` |"
            ),
            encoding="utf-8",
        )

        violations: list[str] = []
        check_documentation_contracts.check_current_spec_handoffs(
            root, violations
        )

        self.assertIn(
            "docs/specs/README.md: declared current packet `docs/specs/GH931/` is missing",
            violations,
        )