ragtime-cli 0.2.18__py3-none-any.whl → 0.3.0__py3-none-any.whl

src/config.py

@@ -51,9 +51,15 @@ class CodeConfig:
 
 @dataclass
 class ConventionsConfig:
-    """Configuration for convention checking."""
+    """Configuration for convention checking and storage."""
+    # Reading conventions
     files: list[str] = field(default_factory=lambda: [".ragtime/CONVENTIONS.md"])
     also_search_memories: bool = True
+    # Writing conventions
+    storage: str = "auto"  # "auto" | "file" | "memory" | "ask"
+    default_file: str = ".ragtime/CONVENTIONS.md"
+    folder: str = ".ragtime/conventions/"
+    scan_docs_for_sections: list[str] = field(default_factory=lambda: ["docs/"])
 
 
 @dataclass
@@ -97,6 +103,12 @@ class RagtimeConfig:
                 also_search_memories=conventions_data.get(
                     "also_search_memories", ConventionsConfig().also_search_memories
                 ),
+                storage=conventions_data.get("storage", ConventionsConfig().storage),
+                default_file=conventions_data.get("default_file", ConventionsConfig().default_file),
+                folder=conventions_data.get("folder", ConventionsConfig().folder),
+                scan_docs_for_sections=conventions_data.get(
+                    "scan_docs_for_sections", ConventionsConfig().scan_docs_for_sections
+                ),
             ),
         )
 
@@ -120,6 +132,10 @@ class RagtimeConfig:
             "conventions": {
                 "files": self.conventions.files,
                 "also_search_memories": self.conventions.also_search_memories,
+                "storage": self.conventions.storage,
+                "default_file": self.conventions.default_file,
+                "folder": self.conventions.folder,
+                "scan_docs_for_sections": self.conventions.scan_docs_for_sections,
             },
         }
 

src/indexers/docs.py

@@ -1,7 +1,7 @@
 """
 Docs indexer - parses markdown files with YAML frontmatter.
 
-Designed for .claude/memory/ style files but works with any markdown.
+Designed for .ragtime/ style files but works with any markdown.
 """
 
 import os
@@ -70,12 +70,23 @@ class Section:
     content: str
     line_start: int
     parent_path: list[str]  # Parent headers for context
+    is_convention: bool = False  # True if this section contains conventions
+
+
+# Headers that indicate convention content
+CONVENTION_HEADERS = {
+    "conventions", "convention", "rules", "standards", "guidelines",
+    "code conventions", "coding conventions", "code standards",
+    "coding standards", "style guide", "code style",
+}
 
 
 def chunk_by_headers(
     content: str,
     min_chunk_size: int = 100,
     max_chunk_size: int = 2000,
+    convention_sections: list[str] | None = None,
+    all_conventions: bool = False,
 ) -> list[Section]:
     """
     Split markdown into sections by headers, preserving hierarchy.
@@ -84,38 +95,69 @@ def chunk_by_headers(
         content: Markdown body (without frontmatter)
         min_chunk_size: Minimum chars to make a standalone section
         max_chunk_size: Maximum chars before splitting further
+        convention_sections: List of section titles to mark as conventions
+        all_conventions: If True, mark ALL sections as conventions
 
     Returns:
         List of Section objects with hierarchical context
     """
     lines = content.split('\n')
     sections: list[Section] = []
-    header_stack: list[tuple[int, str]] = []  # (level, title) for building paths
+    header_stack: list[tuple[int, str, bool]] = []  # (level, title, is_convention)
 
     current_section_lines: list[str] = []
     current_section_start = 0
     current_title = ""
     current_level = 0
+    current_is_convention = False
+    in_convention_marker = False  # Track <!-- convention --> blocks
+
+    def is_convention_header(title: str) -> bool:
+        """Check if header indicates convention content."""
+        normalized = title.lower().strip()
+        return normalized in CONVENTION_HEADERS or any(
+            conv in normalized for conv in ["convention", "rule", "standard", "guideline"]
+        )
 
     def flush_section():
         """Save accumulated lines as a section."""
-        nonlocal current_section_lines, current_section_start, current_title, current_level
+        nonlocal current_section_lines, current_section_start, current_title, current_level, current_is_convention
 
         text = '\n'.join(current_section_lines).strip()
         if text:
             # Build parent path from stack (excluding current)
             parent_path = [h[1] for h in header_stack[:-1]] if header_stack else []
 
+            # Check if any parent is a convention header
+            parent_is_convention = any(h[2] for h in header_stack[:-1]) if header_stack else False
+
+            # Determine if this section is a convention
+            is_conv = (
+                all_conventions or
+                current_is_convention or
+                parent_is_convention or
+                (convention_sections and current_title in convention_sections)
+            )
+
             sections.append(Section(
                 title=current_title or "Introduction",
                 level=current_level,
                 content=text,
                 line_start=current_section_start,
                 parent_path=parent_path,
+                is_convention=is_conv,
             ))
         current_section_lines = []
 
     for i, line in enumerate(lines):
+        # Detect convention markers
+        if '<!-- convention -->' in line.lower() or '<!-- conventions -->' in line.lower():
+            in_convention_marker = True
+            continue
+        if '<!-- /convention -->' in line.lower() or '<!-- /conventions -->' in line.lower():
+            in_convention_marker = False
+            continue
+
         # Detect markdown headers
         header_match = re.match(r'^(#{1,6})\s+(.+)$', line)
 
@@ -126,16 +168,23 @@ def chunk_by_headers(
             level = len(header_match.group(1))
             title = header_match.group(2).strip()
 
+            # Check if this is a convention header
+            is_conv_header = is_convention_header(title)
+
             # Update header stack - pop headers at same or lower level
             while header_stack and header_stack[-1][0] >= level:
                 header_stack.pop()
-            header_stack.append((level, title))
+            header_stack.append((level, title, is_conv_header))
 
             current_title = title
             current_level = level
             current_section_start = i
+            current_is_convention = is_conv_header or in_convention_marker
             current_section_lines = [line]  # Include header in content
         else:
+            # If inside a convention marker, mark the content
+            if in_convention_marker and not current_is_convention:
+                current_is_convention = True
             current_section_lines.append(line)
 
     # Don't forget the last section
@@ -145,8 +194,10 @@ def chunk_by_headers(
     processed: list[Section] = []
     for section in sections:
         if len(section.content) < min_chunk_size and processed:
-            # Merge into previous section
+            # Merge into previous section (inherit is_convention if either has it)
             processed[-1].content += '\n\n' + section.content
+            if section.is_convention:
+                processed[-1].is_convention = True
         elif len(section.content) > max_chunk_size:
             # Split by paragraphs
             paragraphs = re.split(r'\n\n+', section.content)
@@ -161,6 +212,7 @@ def chunk_by_headers(
                         content=current_chunk.strip(),
                         line_start=section.line_start,
                         parent_path=section.parent_path,
+                        is_convention=section.is_convention,
                     ))
                     current_chunk = para
                     chunk_num += 1
@@ -175,6 +227,7 @@ def chunk_by_headers(
                     content=current_chunk.strip(),
                     line_start=section.line_start,
                     parent_path=section.parent_path,
+                    is_convention=section.is_convention,
                 ))
         else:
             processed.append(section)
@@ -213,13 +266,29 @@ def index_file(file_path: Path, hierarchical: bool = True) -> list[DocEntry]:
     base_component = metadata.get("component")
     base_title = metadata.get("title") or file_path.stem
 
+    # Convention detection from frontmatter
+    has_conventions = metadata.get("has_conventions", False)
+    convention_sections = metadata.get("convention_sections", [])
+
+    # Check if filename indicates conventions
+    filename_lower = file_path.stem.lower()
+    is_convention_file = any(
+        term in filename_lower
+        for term in ["convention", "conventions", "rules", "standards", "guidelines"]
+    )
+
     # Short docs: return as single entry
     if not hierarchical or len(body) < 500:
+        # Determine category - convention file or has_conventions flag
+        category = base_category
+        if is_convention_file or has_conventions:
+            category = "convention"
+
         return [DocEntry(
             content=body.strip(),
             file_path=str(file_path),
             namespace=base_namespace,
-            category=base_category,
+            category=category,
             component=base_component,
             title=base_title,
             mtime=mtime,
@@ -229,7 +298,11 @@ def index_file(file_path: Path, hierarchical: bool = True) -> list[DocEntry]:
         )]
 
     # Hierarchical chunking for longer docs
-    sections = chunk_by_headers(body)
+    sections = chunk_by_headers(
+        body,
+        convention_sections=convention_sections,
+        all_conventions=has_conventions or is_convention_file,
+    )
     entries = []
 
     for i, section in enumerate(sections):
@@ -242,11 +315,16 @@ def index_file(file_path: Path, hierarchical: bool = True) -> list[DocEntry]:
         if section.parent_path:
             context_prefix += f"Section: {' > '.join(section.parent_path)}\n\n"
 
+        # Determine category - convention sections get "convention" category
+        category = base_category
+        if section.is_convention:
+            category = "convention"
+
         entries.append(DocEntry(
             content=context_prefix + section.content,
             file_path=str(file_path),
             namespace=base_namespace,
-            category=base_category,
+            category=category,
             component=base_component,
             title=section.title,
             mtime=mtime,

ragtime_cli-0.2.18.dist-info/RECORD

@@ -1,26 +0,0 @@
-ragtime_cli-0.2.18.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
-src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=5UTi586H2S_2rplybhzFbfmfDl-E_YP51KEykVUSi2U,83282
-src/config.py,sha256=tQ6gPLr4ksn2bJPIUjtELFr-k01Eg4g-LDo3GNE6P0Q,4600
-src/db.py,sha256=eWqFGrg3O6hve67EzRJGcAsIpYxWJo4JlrAtlZUUA_s,15169
-src/feedback.py,sha256=cPw_lzusZZPvkgUxs_eV67NtV1FoCfTXUulBPnD78lo,6455
-src/mcp_server.py,sha256=ttXBtWPur6D4FWaJyJf80YaYlkF6Ak6tADNB4tD5N7E,27205
-src/memory.py,sha256=UiHyudKbseMMY-sdcaDSfVBMGj6sFXXw1GxBsZ7nuBc,18450
-src/commands/audit.md,sha256=Xkucm-gfBIMalK9wf7NBbyejpsqBTUAGGlb7GxMtMPY,5137
-src/commands/create-pr.md,sha256=u6-jVkDP_6bJQp6ImK039eY9F6B9E2KlAVlvLY-WV6Q,9483
-src/commands/generate-docs.md,sha256=9W2Yy-PDyC3p5k39uEb31z5YAHkSKsQLg6gV3tLgSnQ,7015
-src/commands/handoff.md,sha256=8VxTddtW08jGTW36GW_rS77JdeSn8vHeMfklrWwVUD4,5055
-src/commands/import-docs.md,sha256=ByIdcfbdiF77HoFv5U6zZ_YvZf00-hAs9EMconXssvY,6927
-src/commands/pr-graduate.md,sha256=nXJMuXeOp0SZfjQ567NUO02Rg9zPQHQFbZbJ4Q_His0,6692
-src/commands/recall.md,sha256=unQPWsmocKRoQR7jRtjrj8aVcMHverjGR6u5mYL8TLw,6008
-src/commands/remember.md,sha256=nNewsUhIqF4wtD1jhVDZvmLZjdcmPN6NmUM43SdWepc,5368
-src/commands/save.md,sha256=7gTpW46AU9Y4l8XVZ8f4h1sEdBfVqIRA7hlidUxMAC4,251
-src/commands/start.md,sha256=qoqhkMgET74DBx8YPIT1-wqCiVBUDxlmevigsCinHSY,6506
-src/indexers/__init__.py,sha256=MYoCPZUpHakMX1s2vWnc9shjWfx_X1_0JzUhpKhnKUQ,454
-src/indexers/code.py,sha256=G2TbiKbWj0e7DV5KsU8-Ggw6ziDb4zTuZ4Bu3ryV4g8,18059
-src/indexers/docs.py,sha256=Q8krHYw0bybUyZaq1sJ0r6Fv-I_6BjTufhqI1eg_25s,9992
-ragtime_cli-0.2.18.dist-info/METADATA,sha256=yzNcOmjrR3rL8K5cnwYa1Y6PZeHKpU4CJfTlcSx1A9Q,13354
-ragtime_cli-0.2.18.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.2.18.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.2.18.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.2.18.dist-info/RECORD,,

src/commands/audit.md

@@ -1,151 +0,0 @@
----
-description: Audit local memories for duplicates, conflicts, and stale data
-allowed-tools: Bash, mcp__ragtime__search, mcp__ragtime__list_memories, mcp__ragtime__forget, mcp__ragtime__update_status, AskUserQuestion
----
-
-# Memory Audit
-
-Periodic cleanup of local memories. This is a **human-in-the-loop** review - no automatic deletions.
-
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     CUSTOMIZABLE: Add project-specific audit rules, adjust the report format,
-     add custom namespace checks, etc.
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
-## Namespaces to Audit
-
-- `app` - Codebase knowledge (architecture, decisions)
-- `team` - Team conventions (standards, processes)
-- `user-*` - Developer preferences
-- `branch-*` - Branch-specific context and decisions
-
-## Step 1: Gather All Memories
-
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     RAGTIME CORE - DO NOT MODIFY
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
-```
-mcp__ragtime__list_memories:
-  limit: 100
-```
-
-For each namespace:
-```
-mcp__ragtime__list_memories:
-  namespace: "{namespace}"
-  limit: 50
-```
-
-<!-- ═══════════════════════════════════════════════════════════════════════════ -->
-
-## Step 2: Identify Issues
-
-Group memories by topic and identify:
-
-| Issue | Description |
-|-------|-------------|
-| **DUPLICATES** | Memories saying essentially the same thing |
-| **CONFLICTS** | Memories that contradict each other |
-| **STALE** | References to code/features that no longer exist |
-| **ORPHANED** | Branch memories for deleted/merged branches |
-| **LOW_VALUE** | Vague memories that aren't useful |
-
-## Step 3: Check for Stale Branches
-
-```bash
-# List branch memory folders
-ls -la .claude/memory/branches/
-
-# For each, check if branch still exists
-for dir in .claude/memory/branches/*/; do
-  branch_slug=$(basename "$dir")
-  # Check if branch exists on remote
-  if ! git branch -a | grep -q "$branch_slug"; then
-    echo "⚠️  Potentially stale: $branch_slug"
-  fi
-done
-```
-
-Also run:
-```bash
-ragtime prune --dry-run
-```
-
-## Step 4: Present Report
-
-```
-## Memory Audit Report
-
-### App Namespace ({count} memories)
-- Potential duplicates: {n}
-- Potential conflicts: {n}
-- Possibly stale: {n}
-
-### Team Namespace ({count} memories)
-- Potential duplicates: {n}
-
-### Branch Namespaces
-- Active branches: {n}
-- Stale (unmerged) folders: {n}
-- Ready to prune: {n}
-
-───────────────────────────────────────────
-
-### Issues Found:
-
-**1. Possible Duplicate:**
-- "Auth uses JWT tokens" (app, abc123)
-- "JWT auth with 15-min expiry" (app, def456)
-→ Action: Merge into one?
-
-**2. Possible Conflict:**
-- "Use tabs for indentation" (team, ghi789)
-- "Use 2-space indentation" (team, jkl012)
-→ Action: Which is correct?
-
-**3. Stale Branch:**
-- branches/old-feature/ (branch deleted)
-→ Action: Prune with `ragtime prune`?
-```
-
-## Step 5: Get User Approval
-
-For each issue found, ask:
-
-- "Should I merge these duplicates?"
-- "Which of these conflicting memories is correct?"
-- "Should I mark this as abandoned?"
-- "Run `ragtime prune` to clean stale branches?"
-
-Only make changes the user explicitly approves.
-
-## Step 6: Execute Approved Actions
-
-<!-- ═══════════════════════════════════════════════════════════════════════════
-     RAGTIME CORE - DO NOT MODIFY
-     ═══════════════════════════════════════════════════════════════════════════ -->
-
-**Delete a memory:**
-```
-mcp__ragtime__forget:
-  memory_id: "{id}"
-```
-
-**Mark as abandoned:**
-```
-mcp__ragtime__update_status:
-  memory_id: "{id}"
-  status: "abandoned"
-```
-
-**Prune stale branches:**
-```bash
-ragtime prune
-```
-
-<!-- ═══════════════════════════════════════════════════════════════════════════ -->
-
-## Suggested Cadence
-
-Run monthly or when memories feel cluttered.