doclogs-cli 0.1.1__tar.gz → 0.1.2__tar.gz

{doclogs_cli-0.1.1/doclogs_cli.egg-info → doclogs_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doclogs-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: CLI for capturing engineering work and turning it into career artifacts.
 Author: Mridul Tiwari
 License-Expression: MIT

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/commands/capture.py

@@ -14,11 +14,25 @@ def _print_summary(entry, path) -> None:
     typer.echo(f"   commits today: {len(entry.commits)}")
 
 
+def _notes_with_topic(notes: str, topic: str | None) -> str:
+    if not topic or not topic.strip():
+        return notes
+    topic_line = f"topic: {topic.strip()}"
+    if notes.lstrip().startswith("topic:"):
+        return notes
+    return f"{topic_line}\n{notes}"
+
+
 def register(app: typer.Typer):
 
     @app.command("capture", help="Capture today's engineering work into local storage.")
     def capture(
         notes: Optional[str] = typer.Option(None, "-n", "--notes", help="Optional notes (skips interactive prompts)."),
+        topic: Optional[str] = typer.Option(
+            None,
+            "--topic",
+            help="Short task name (used in weekly review and doclog generate -t).",
+        ),
         no_interactive: bool = typer.Option(False, "--no-interactive", help="Skip questions; git-only capture."),
         include_terminal: bool = typer.Option(False, help="Include optional terminal history evidence."),
         include_tickets: bool = typer.Option(False, help="Include optional ticket IDs or issue references."),
@@ -34,7 +48,7 @@ def register(app: typer.Typer):
             entry = None
             saved_any = False
 
-            for batch, replace in iter_interactive_tasks():
+            for batch, replace in iter_interactive_tasks(topic=topic):
                 entry = build_capture_entry(notes=batch, replace_notes=replace)
                 path = save_entry(entry)
                 saved_any = True
@@ -48,7 +62,7 @@ def register(app: typer.Typer):
             return
 
         # Non-interactive: git only or single --notes
-        final_notes = merge_notes(notes)
+        final_notes = merge_notes(_notes_with_topic(notes, topic) if notes else None)
         entry = build_capture_entry(notes=final_notes)
         path = save_entry(entry)
-        _print_summary(entry, path)
+        _print_summary(entry, path)

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2/doclogs_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doclogs-cli
-Version: 0.1.1
+Version: 0.1.2
 Summary: CLI for capturing engineering work and turning it into career artifacts.
 Author: Mridul Tiwari
 License-Expression: MIT

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/helper/capture_prompts.py

@@ -59,28 +59,38 @@ def _next_task_number() -> int:
     return max(nums, default=0) + 1
 
 
-def iter_interactive_tasks():
+def iter_interactive_tasks(topic: str | None = None):
     updated = maybe_complete_stub()
     if updated:
         yield updated, True   # ← replace entire notes
     task_num = _next_task_number()
+    first_task = True
     while True:
         typer.echo(f"\n--- Task {task_num} ---\n")
-        batch = collect_interactive_notes()
+        default_topic = topic if first_task else None
+        batch = collect_interactive_notes(default_topic=default_topic)
+        first_task = False
         if batch:
             yield f"### Task {task_num}\n{batch}", False   # ← append new task
         if not typer.confirm("Add another task?", default=False):
             break
         task_num += 1
 
-def collect_interactive_notes() -> str | None:
+def collect_interactive_notes(default_topic: str | None = None) -> str | None:
     typer.echo("\n📋 Daily capture — answer briefly (Enter to skip optional questions)\n")
 
+    topic_answer = typer.prompt(
+        "Task topic (short name for weekly & generate)",
+        default=default_topic or "",
+    ).strip()
     worked_on = typer.prompt("What did you work on today?", default="").strip()
     if not worked_on:
         return None
 
-    lines = [f"worked_on: {worked_on}"]
+    lines: list[str] = []
+    if topic_answer:
+        lines.append(f"topic: {topic_answer}")
+    lines.append(f"worked_on: {worked_on}")
 
     if typer.confirm("Add more details later?", default=False):
         lines.append("status: details_later")

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/helper/story.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import re
 
-from helper.task_notes import extract_worked_on, normalize_title, parse_task_blocks
+from helper.task_notes import extract_topic, extract_worked_on, normalize_title, parse_task_blocks, story_title
 from helper.weekly import build_story_candidates, load_entries_for_days
 
 _WEEKLY_DATE_SUFFIX = re.compile(r"\s+\(\d{4}-\d{2}-\d{2}\)\s*$")
@@ -53,14 +53,16 @@ def find_story_text(title: str, days: int = 7) -> str | None:
                 )
 
         for block in parse_task_blocks(entry.notes):
-            task_title = extract_worked_on(block)
-            if not task_title:
+            titles = _task_titles(block)
+            if not titles:
                 continue
-            candidate = normalize_title(task_title)
-            if candidate == needle:
-                return block
-            if _is_partial_match(needle, candidate):
-                partial_matches.append(block)
+            for candidate in titles:
+                normalized = normalize_title(candidate)
+                if needle == normalized:
+                    return block
+                if _is_partial_match(needle, normalized):
+                    partial_matches.append(block)
+                    break
 
     if len(partial_matches) == 1:
         return partial_matches[0]
@@ -68,6 +70,21 @@ def find_story_text(title: str, days: int = 7) -> str | None:
 
 
 def _is_partial_match(needle: str, candidate: str) -> bool:
-    if len(needle) < 8:
+    if len(needle) < 3:
         return False
     return needle in candidate or candidate in needle
+
+
+def _task_titles(block: str) -> list[str]:
+    titles: list[str] = []
+    topic = extract_topic(block)
+    worked_on = extract_worked_on(block)
+    if topic:
+        titles.append(topic)
+    if worked_on and worked_on not in titles:
+        titles.append(worked_on)
+    if not titles:
+        fallback = story_title(block)
+        if fallback:
+            titles.append(fallback)
+    return titles

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/helper/syntax.py

@@ -37,6 +37,7 @@ SYNTAX: dict[str, CommandSyntax] = {
         usage="doclog capture [OPTIONS]",
         options=(
             "-n, --notes TEXT       Notes text (skips interactive prompts)",
+            "--topic TEXT           Short task name (weekly & generate -t)",
             "--no-interactive       Git-only capture; skip questions",
             "--include-terminal     Include terminal history (planned)",
             "--include-tickets      Include ticket IDs (planned)",
@@ -44,6 +45,8 @@ SYNTAX: dict[str, CommandSyntax] = {
         ),
         examples=(
             "doclog capture",
+            "doclog capture --topic \"nginx akamai TLS\"",
+            'doclog capture --topic "DocLogs" -n "worked_on: shipped publish command"',
             "doclog capture --no-interactive",
             'doclog capture -n "Fixed nginx TLS handshake with Akamai"',
             "doclog capture --syntax",

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/helper/task_notes.py

@@ -17,6 +17,19 @@ def extract_worked_on(block: str) -> str | None:
     return _extract_worked_on(block)
 
 
+def extract_topic(block: str) -> str | None:
+    return _extract_field(
+        block,
+        "topic",
+        stop_fields=("worked_on", "impact", "blockers", "remember", "status", "### Task"),
+    )
+
+
+def story_title(block: str) -> str | None:
+    """Short label for weekly/generate; prefers topic over worked_on."""
+    return extract_topic(block) or extract_worked_on(block)
+
+
 def normalize_title(text: str) -> str:
     """Collapse whitespace and lowercase for fuzzy title matching."""
     return " ".join(text.strip().lower().split())
@@ -33,21 +46,27 @@ def list_incomplete_tasks(notes: str | None) -> list[tuple[int, str]]:
             continue
         match = re.search(r"### Task (\d+)", block)
         task_num = int(match.group(1)) if match else 0
-        summary = _extract_worked_on(block) or (f"Task {task_num}" if task_num else "Incomplete entry")
+        summary = story_title(block) or (f"Task {task_num}" if task_num else "Incomplete entry")
         results.append((task_num, summary))
 
     return results
 
 
 def _extract_worked_on(block: str) -> str | None:
-    match = re.search(
-        r"worked_on:\s*(.+?)(?=\n(?:impact|blockers|remember|status:|### Task|\Z))",
+    return _extract_field(
         block,
-        re.DOTALL,
+        "worked_on",
+        stop_fields=("topic", "impact", "blockers", "remember", "status", "### Task"),
     )
+
+
+def _extract_field(block: str, field: str, *, stop_fields: tuple[str, ...]) -> str | None:
+    stops = "|".join(re.escape(name) for name in stop_fields)
+    pattern = rf"{field}:\s*(.+?)(?=\n(?:{stops}|\Z))"
+    match = re.search(pattern, block, re.DOTALL)
     if not match:
         return None
-    return " ".join(match.group(1).split())  # flatten multiline YAML
+    return " ".join(match.group(1).split())
 
 
 def complete_task(notes: str, task_num: int, followup: str) -> str:
@@ -61,7 +80,9 @@ def complete_task(notes: str, task_num: int, followup: str) -> str:
         if not match:
             raise ValueError(f"Task {task_num} not found")
         worked_on = _extract_worked_on(match.group(0)) or ""
-        new_block = f"### Task {task_num}\nworked_on: {worked_on}\n{followup}"
+        topic = extract_topic(match.group(0))
+        topic_line = f"topic: {topic}\n" if topic else ""
+        new_block = f"### Task {task_num}\n{topic_line}worked_on: {worked_on}\n{followup}"
 
     match = re.search(pattern, notes, re.DOTALL)
     if not match:

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/helper/weekly.py

@@ -5,7 +5,7 @@ from datetime import date, timedelta
 
 from helper.entry import DailyEntry, load_entry
 from helper.paths import entries_dir
-from helper.task_notes import DETAILS_LATER, extract_worked_on, parse_task_blocks
+from helper.task_notes import DETAILS_LATER, parse_task_blocks, story_title
 
 
 @dataclass
@@ -45,7 +45,7 @@ def build_story_candidates(
                 )
 
         for block in parse_task_blocks(entry.notes):
-            title = extract_worked_on(block)
+            title = story_title(block)
             if not title:
                 continue
             key = title.lower()

{doclogs_cli-0.1.1 → doclogs_cli-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "doclogs-cli"
-version = "0.1.1"
+version = "0.1.2"
 description = "CLI for capturing engineering work and turning it into career artifacts."
 readme = "README.md"
 license = "MIT"