agenticstackfile 0.1.3__tar.gz → 0.2.0__tar.gz

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenticstackfile
-Version: 0.1.3
+Version: 0.2.0
 Summary: Instant codebase map for AI agents — understand any project before making changes
 Author-email: Rajat Handa <handarajat111@gmail.com>
 License-Expression: MIT
@@ -14,6 +14,7 @@ Requires-Dist: openai>=1.0.0; extra == "openai"
 Provides-Extra: all
 Requires-Dist: anthropic>=0.20.0; extra == "all"
 Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: watchdog>=3.0.0; extra == "all"
 
 # AgenticStack
 

agenticstackfile-0.2.0/agenticstack/cli.py

@@ -0,0 +1,110 @@
+import click
+from pathlib import Path
+from datetime import datetime
+from .config import create_default_config, config_exists, write_config, read_config, create_default_ignore_file
+from .core import run
+
+
+def _check_staleness(config: dict) -> None:
+    output_file = Path(config.get("output_file", "AgenticStack.txt"))
+    if not output_file.exists():
+        return
+    age_seconds = (datetime.now() - datetime.fromtimestamp(output_file.stat().st_mtime)).total_seconds()
+    thresholds = {"realtime": 300, "hourly": 3600, "daily": 86400}
+    sync_time = config.get("sync_time", "false")
+    threshold = thresholds.get(sync_time)
+    if threshold and age_seconds > threshold:
+        hours = int(age_seconds // 3600)
+        minutes = int((age_seconds % 3600) // 60)
+        click.echo(f"WARNING: AgenticStack.txt was last updated {hours}h {minutes}m ago. Consider running 'agenticstack update'.")
+
+
+def _start_background_services(config: dict, root_path: Path) -> None:
+    if config.get("sync_trigger", "false").lower() != "true":
+        return
+    sync_time = config.get("sync_time", "hourly")
+    try:
+        from .watcher import start_watcher
+        from .scheduler import start_scheduler
+        start_watcher(root_path)
+        start_scheduler(root_path, sync_time)
+        click.echo(f"AgenticStack: Auto sync enabled ({sync_time})")
+    except ImportError as e:
+        click.echo(f"WARNING: {e}")
+
+
+@click.group()
+def main():
+    """AgenticStack — instant codebase map for AI agents."""
+    pass
+
+
+@main.command()
+@click.option("--api-key", default=None, help="Your LLM provider API key")
+@click.option("--provider", default=None, help="Provider: anthropic or openai")
+@click.option("--model", default=None, help="Model: default, fast, or smart")
+def init(api_key, provider, model):
+    """Initialize AgenticStack in this project."""
+    if config_exists():
+        click.echo("AgenticStack: Config already exists. Use 'agenticstack update' to refresh.")
+        return
+
+    create_default_config()
+    click.echo("AgenticStack: Created .agenticstack.ini")
+    create_default_ignore_file()
+    click.echo("AgenticStack: Created .agenticstackignore")
+
+    if api_key:
+        write_config("api_key", api_key)
+    if provider:
+        write_config("provider", provider)
+    if model:
+        write_config("model", model)
+
+    config = read_config()
+    _start_background_services(config, Path.cwd())
+    run(Path.cwd())
+
+
+@main.command()
+def update():
+    """Refresh AgenticStack.txt for this project."""
+    if not config_exists():
+        click.echo("AgenticStack: No config found. Run 'agenticstack init' first.")
+        return
+
+    config = read_config()
+    _check_staleness(config)
+    _start_background_services(config, Path.cwd())
+    run(Path.cwd())
+
+
+@main.command()
+def watch():
+    """Watch for file changes and auto sync AgenticStack.txt."""
+    if not config_exists():
+        click.echo("AgenticStack: No config found. Run 'agenticstack init' first.")
+        return
+
+    config = read_config()
+    sync_time = config.get("sync_time", "hourly")
+    root_path = Path.cwd()
+
+    try:
+        from .watcher import start_watcher
+        from .scheduler import start_scheduler
+        import time
+
+        start_watcher(root_path)
+        start_scheduler(root_path, sync_time)
+
+        click.echo(f"AgenticStack: Watching for changes ({sync_time} sync)...")
+        click.echo("Press Ctrl+C to stop.")
+
+        while True:
+            time.sleep(1)
+
+    except ImportError as e:
+        click.echo(f"ERROR: {e}")
+    except KeyboardInterrupt:
+        click.echo("\nAgenticStack: Watch stopped.")

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/agenticstack/config.py

@@ -11,6 +11,8 @@ DEFAULTS = {
     "language": "auto",
     "output_file": "AgenticStack.txt",
     "depth": "standard",
+    "sync_trigger": "false",
+    "sync_time": "hourly",
 }
 
 
@@ -50,16 +52,18 @@ def write_config(key: str, value: str) -> None:
 
 def _add_to_gitignore() -> None:
     gitignore_path = Path.cwd() / ".gitignore"
-    entry = CONFIG_FILE
+    entries = [CONFIG_FILE, ".agenticstack_pending"]
 
     if gitignore_path.exists():
         content = gitignore_path.read_text()
-        if entry not in content:
-            with open(gitignore_path, "a") as f:
-                f.write(f"\n{entry}\n")
+        with open(gitignore_path, "a") as f:
+            for entry in entries:
+                if entry not in content:
+                    f.write(f"\n{entry}\n")
     else:
         with open(gitignore_path, "w") as f:
-            f.write(f"{entry}\n")
+            for entry in entries:
+                f.write(f"{entry}\n")
 
 
 def create_default_ignore_file() -> None:

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/agenticstack/core.py

@@ -50,5 +50,5 @@ def run(root_path: Path = None) -> None:
         final_output = static_output
 
     output_file = config.get("output_file", "AgenticStack.txt")
-    write_output(final_output, Path(output_file))
+    write_output(final_output, Path(output_file), sync_time=config.get("sync_time", "false"))
     print(f"AgenticStack: Done. Output written to {output_file}")

agenticstackfile-0.2.0/agenticstack/scheduler.py

@@ -0,0 +1,41 @@
+import threading
+from pathlib import Path
+
+
+SYNC_INTERVALS = {
+    "realtime": 300,
+    "hourly": 3600,
+    "daily": 86400,
+}
+
+
+def start_scheduler(root_path: Path, sync_time: str) -> None:
+    interval = SYNC_INTERVALS.get(sync_time)
+
+    if not interval:
+        print(f"AgenticStack: Scheduler — unknown sync_time '{sync_time}', skipping.")
+        return
+
+    print(f"AgenticStack: Scheduler started — will sync every {interval} seconds.")
+
+    def sync_loop():
+        from .watcher import has_pending_changes, clear_pending
+        from .core import run
+
+        print("AgenticStack: Scheduler tick — checking for pending changes...")
+
+        if has_pending_changes(root_path):
+            print("AgenticStack: Pending changes detected — syncing...")
+            clear_pending(root_path)
+            run(root_path)
+            print("AgenticStack: Sync complete.")
+        else:
+            print("AgenticStack: No pending changes — skipping.")
+
+        timer = threading.Timer(interval, sync_loop)
+        timer.daemon = True
+        timer.start()
+
+    timer = threading.Timer(interval, sync_loop)
+    timer.daemon = True
+    timer.start()

agenticstackfile-0.2.0/agenticstack/watcher.py

@@ -0,0 +1,64 @@
+from pathlib import Path
+from datetime import datetime
+
+
+PENDING_FILE = ".agenticstack_pending"
+
+
+def record_change(filepath: str, root_path: Path) -> None:
+    pending_path = root_path / PENDING_FILE
+    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    with open(pending_path, "a") as f:
+        f.write(f"{timestamp} | {filepath}\n")
+
+
+def has_pending_changes(root_path: Path) -> bool:
+    pending_path = root_path / PENDING_FILE
+    if not pending_path.exists():
+        return False
+    return pending_path.read_text().strip() != ""
+
+
+def clear_pending(root_path: Path) -> None:
+    pending_path = root_path / PENDING_FILE
+    if pending_path.exists():
+        pending_path.write_text("")
+
+
+def start_watcher(root_path: Path) -> None:
+    try:
+        from watchdog.observers import Observer
+        from watchdog.events import FileSystemEventHandler
+        IGNORE_FILES = {
+            ".agenticstack_pending",
+            ".agenticstack.ini",
+            "AgenticStack.txt",
+            ".agenticstackignore",
+        }
+
+        class ChangeHandler(FileSystemEventHandler):
+            def _should_ignore(self, path: str) -> bool:
+                filename = Path(path).name
+                return filename in IGNORE_FILES
+
+            def on_modified(self, event):
+                if not event.is_directory and not self._should_ignore(event.src_path):
+                    record_change(event.src_path, root_path)
+                    print(f"AgenticStack: Change detected — {event.src_path}")
+
+            def on_created(self, event):
+                if not event.is_directory and not self._should_ignore(event.src_path):
+                    record_change(event.src_path, root_path)
+                    print(f"AgenticStack: New file detected — {event.src_path}")
+
+        observer = Observer()
+        observer.schedule(ChangeHandler(), str(root_path), recursive=True)
+        observer.daemon = True
+        observer.start()
+        print(f"AgenticStack: Watcher started on {root_path}")
+
+    except ImportError:
+        raise ImportError(
+            "watchdog not installed. "
+            "Run: pip install 'agenticstackfile[watch]'"
+        )

agenticstackfile-0.2.0/agenticstack/writer.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+from datetime import datetime
+
+SYNC_INTERVALS = {
+    "realtime": "every 2 minutes",
+    "hourly": "every 1 hour",
+    "daily": "every 24 hours",
+    "false": "manual only",
+}
+
+def write_output(content: str, output_path: Path, sync_time: str = "false") -> None:
+    now = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    sync_label = SYNC_INTERVALS.get(sync_time, "manual only")
+
+    header = f"""============================================================
+            AGENTICSTACK — CODEBASE MAP
+            Generated: {now}
+            Auto sync: {sync_label}
+            WARNING: Run 'agenticstack update' to force refresh anytime
+            ============================================================
+
+            """
+    output_path.write_text(header + content, encoding="utf-8")

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/agenticstackfile.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agenticstackfile
-Version: 0.1.3
+Version: 0.2.0
 Summary: Instant codebase map for AI agents — understand any project before making changes
 Author-email: Rajat Handa <handarajat111@gmail.com>
 License-Expression: MIT
@@ -14,6 +14,7 @@ Requires-Dist: openai>=1.0.0; extra == "openai"
 Provides-Extra: all
 Requires-Dist: anthropic>=0.20.0; extra == "all"
 Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: watchdog>=3.0.0; extra == "all"
 
 # AgenticStack
 

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/agenticstackfile.egg-info/SOURCES.txt

@@ -6,6 +6,8 @@ agenticstack/config.py
 agenticstack/core.py
 agenticstack/errors.py
 agenticstack/prompt.py
+agenticstack/scheduler.py
+agenticstack/watcher.py
 agenticstack/writer.py
 agenticstack/analyzer/__init__.py
 agenticstack/analyzer/base.py

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/agenticstackfile.egg-info/requires.txt

@@ -3,6 +3,7 @@ click>=8.0.0
 [all]
 anthropic>=0.20.0
 openai>=1.0.0
+watchdog>=3.0.0
 
 [anthropic]
 anthropic>=0.20.0

{agenticstackfile-0.1.3 → agenticstackfile-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agenticstackfile"
-version = "0.1.3"
+version = "0.2.0"
 description = "Instant codebase map for AI agents — understand any project before making changes"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -19,7 +19,7 @@ dependencies = [
 [project.optional-dependencies]
 anthropic = ["anthropic>=0.20.0"]
 openai = ["openai>=1.0.0"]
-all = ["anthropic>=0.20.0", "openai>=1.0.0"]
+all = ["anthropic>=0.20.0", "openai>=1.0.0", "watchdog>=3.0.0"]
 
 [project.scripts]
 agenticstack = "agenticstack.cli:main"

agenticstackfile-0.1.3/agenticstack/cli.py

@@ -1,45 +0,0 @@
-import click
-from pathlib import Path
-from .config import create_default_config, config_exists, write_config, read_config, create_default_ignore_file
-from .core import run
-
-
-@click.group()
-def main():
-    """AgenticStack — instant codebase map for AI agents."""
-    pass
-
-
-@main.command()
-@click.option("--api-key", default=None, help="Your LLM provider API key")
-@click.option("--provider", default=None, help="Provider: anthropic or openai")
-@click.option("--model", default=None, help="Model: default, fast, or smart")
-def init(api_key, provider, model):
-    """Initialize AgenticStack in this project."""
-    if config_exists():
-        click.echo("AgenticStack: Config already exists. Use 'agenticstack update' to refresh.")
-        return
-
-    create_default_config()
-    click.echo("AgenticStack: Created .agenticstack.ini")
-    create_default_ignore_file()
-    click.echo("AgenticStack: Created .agenticstackignore")
-
-    if api_key:
-        write_config("api_key", api_key)
-    if provider:
-        write_config("provider", provider)
-    if model:
-        write_config("model", model)
-
-    run(Path.cwd())
-
-
-@main.command()
-def update():
-    """Refresh AgenticStack.txt for this project."""
-    if not config_exists():
-        click.echo("AgenticStack: No config found. Run 'agenticstack init' first.")
-        return
-
-    run(Path.cwd())

agenticstackfile-0.1.3/agenticstack/writer.py

@@ -1,5 +0,0 @@
-from pathlib import Path
-
-
-def write_output(content: str, output_path: Path) -> None:
-    output_path.write_text(content, encoding="utf-8")