agenticstackfile 0.1.3__tar.gz → 0.2.1__tar.gz

agenticstackfile-0.2.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: agenticstackfile
+Version: 0.2.1
+Summary: Instant codebase map for AI agents — understand any project before making changes
+Author-email: Rajat Handa <handarajat111@gmail.com>
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
+Provides-Extra: openai
+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
+
+Instant codebase map for AI agents — understand any Python project before making changes.
+
+## What it does
+
+AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
+
+- Where every model, view, serializer, service, and utility lives
+- Which files to touch when making a specific change
+- How your project is structured by framework (Django, Flask, FastAPI, or plain Python)
+- A step-by-step change guide using your actual file paths
+
+## Installation
+
+```bash
+pip install agenticstackfile
+```
+
+With AI support:
+
+```bash
+pip install 'agenticstackfile[anthropic]'
+pip install 'agenticstackfile[openai]'
+```
+
+With auto-sync (watch mode):
+
+```bash
+pip install 'agenticstackfile[watch]'
+```
+
+Everything at once:
+
+```bash
+pip install 'agenticstackfile[all]'
+```
+
+## Usage
+
+```bash
+agenticstack init      # First-time setup — creates config and ignore file
+agenticstack update    # Manually refresh AgenticStack.txt
+agenticstack watch     # Auto-sync mode — watches for file changes and syncs automatically
+```
+
+## Auto-sync (Watch Mode)
+
+`agenticstack watch` runs two background services:
+
+- **Watcher** — monitors your project for file changes in real time
+- **Scheduler** — syncs `AgenticStack.txt` automatically based on your configured interval
+
+Only syncs when files have actually changed — no wasted API tokens.
+
+Requires `watchdog`: `pip install 'agenticstackfile[watch]'`
+
+## Modes
+
+**Static mode** — no API key needed. Uses Python AST to map your codebase for free.
+
+**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation with change guides tailored to your framework.
+
+## Configuration
+
+Edit `.agenticstack.ini` in your project root:
+
+```ini
+[agenticstack]
+provider = anthropic
+model = default
+api_key = YOUR_API_KEY
+output_file = AgenticStack.txt
+depth = standard
+sync_trigger = false
+sync_time = hourly
+```
+
+| Key | Values | Description |
+|---|---|---|
+| `provider` | `anthropic`, `openai` | AI provider to use |
+| `model` | `default`, or model name | Model to use. `default` picks the best available. |
+| `api_key` | your key | API key for AI mode |
+| `output_file` | filename | Output file name |
+| `depth` | `standard` | Analysis depth |
+| `sync_trigger` | `true`, `false` | Enable auto-sync in watch mode |
+| `sync_time` | `realtime`, `hourly`, `daily` | How often to sync when changes are detected |
+
+## Ignoring Files
+
+Create `.agenticstackignore` in your project root (auto-created by `agenticstack init`):

agenticstackfile-0.2.1/README.md

@@ -0,0 +1,91 @@
+# AgenticStack
+
+Instant codebase map for AI agents — understand any Python project before making changes.
+
+## What it does
+
+AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
+
+- Where every model, view, serializer, service, and utility lives
+- Which files to touch when making a specific change
+- How your project is structured by framework (Django, Flask, FastAPI, or plain Python)
+- A step-by-step change guide using your actual file paths
+
+## Installation
+
+```bash
+pip install agenticstackfile
+```
+
+With AI support:
+
+```bash
+pip install 'agenticstackfile[anthropic]'
+pip install 'agenticstackfile[openai]'
+```
+
+With auto-sync (watch mode):
+
+```bash
+pip install 'agenticstackfile[watch]'
+```
+
+Everything at once:
+
+```bash
+pip install 'agenticstackfile[all]'
+```
+
+## Usage
+
+```bash
+agenticstack init      # First-time setup — creates config and ignore file
+agenticstack update    # Manually refresh AgenticStack.txt
+agenticstack watch     # Auto-sync mode — watches for file changes and syncs automatically
+```
+
+## Auto-sync (Watch Mode)
+
+`agenticstack watch` runs two background services:
+
+- **Watcher** — monitors your project for file changes in real time
+- **Scheduler** — syncs `AgenticStack.txt` automatically based on your configured interval
+
+Only syncs when files have actually changed — no wasted API tokens.
+
+Requires `watchdog`: `pip install 'agenticstackfile[watch]'`
+
+## Modes
+
+**Static mode** — no API key needed. Uses Python AST to map your codebase for free.
+
+**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation with change guides tailored to your framework.
+
+## Configuration
+
+Edit `.agenticstack.ini` in your project root:
+
+```ini
+[agenticstack]
+provider = anthropic
+model = default
+api_key = YOUR_API_KEY
+output_file = AgenticStack.txt
+depth = standard
+sync_trigger = false
+sync_time = hourly
+```
+
+| Key | Values | Description |
+|---|---|---|
+| `provider` | `anthropic`, `openai` | AI provider to use |
+| `model` | `default`, or model name | Model to use. `default` picks the best available. |
+| `api_key` | your key | API key for AI mode |
+| `output_file` | filename | Output file name |
+| `depth` | `standard` | Analysis depth |
+| `sync_trigger` | `true`, `false` | Enable auto-sync in watch mode |
+| `sync_time` | `realtime`, `hourly`, `daily` | How often to sync when changes are detected |
+
+## Ignoring Files
+
+Create `.agenticstackignore` in your project root (auto-created by `agenticstack init`):

agenticstackfile-0.2.1/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.1}/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.1}/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.1/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.1/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.1/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.2.1/agenticstackfile.egg-info/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: agenticstackfile
+Version: 0.2.1
+Summary: Instant codebase map for AI agents — understand any project before making changes
+Author-email: Rajat Handa <handarajat111@gmail.com>
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
+Provides-Extra: openai
+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
+
+Instant codebase map for AI agents — understand any Python project before making changes.
+
+## What it does
+
+AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
+
+- Where every model, view, serializer, service, and utility lives
+- Which files to touch when making a specific change
+- How your project is structured by framework (Django, Flask, FastAPI, or plain Python)
+- A step-by-step change guide using your actual file paths
+
+## Installation
+
+```bash
+pip install agenticstackfile
+```
+
+With AI support:
+
+```bash
+pip install 'agenticstackfile[anthropic]'
+pip install 'agenticstackfile[openai]'
+```
+
+With auto-sync (watch mode):
+
+```bash
+pip install 'agenticstackfile[watch]'
+```
+
+Everything at once:
+
+```bash
+pip install 'agenticstackfile[all]'
+```
+
+## Usage
+
+```bash
+agenticstack init      # First-time setup — creates config and ignore file
+agenticstack update    # Manually refresh AgenticStack.txt
+agenticstack watch     # Auto-sync mode — watches for file changes and syncs automatically
+```
+
+## Auto-sync (Watch Mode)
+
+`agenticstack watch` runs two background services:
+
+- **Watcher** — monitors your project for file changes in real time
+- **Scheduler** — syncs `AgenticStack.txt` automatically based on your configured interval
+
+Only syncs when files have actually changed — no wasted API tokens.
+
+Requires `watchdog`: `pip install 'agenticstackfile[watch]'`
+
+## Modes
+
+**Static mode** — no API key needed. Uses Python AST to map your codebase for free.
+
+**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation with change guides tailored to your framework.
+
+## Configuration
+
+Edit `.agenticstack.ini` in your project root:
+
+```ini
+[agenticstack]
+provider = anthropic
+model = default
+api_key = YOUR_API_KEY
+output_file = AgenticStack.txt
+depth = standard
+sync_trigger = false
+sync_time = hourly
+```
+
+| Key | Values | Description |
+|---|---|---|
+| `provider` | `anthropic`, `openai` | AI provider to use |
+| `model` | `default`, or model name | Model to use. `default` picks the best available. |
+| `api_key` | your key | API key for AI mode |
+| `output_file` | filename | Output file name |
+| `depth` | `standard` | Analysis depth |
+| `sync_trigger` | `true`, `false` | Enable auto-sync in watch mode |
+| `sync_time` | `realtime`, `hourly`, `daily` | How often to sync when changes are detected |
+
+## Ignoring Files
+
+Create `.agenticstackignore` in your project root (auto-created by `agenticstack init`):

{agenticstackfile-0.1.3 → agenticstackfile-0.2.1}/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.1}/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.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agenticstackfile"
-version = "0.1.3"
+version = "0.2.1"
 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/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: agenticstackfile
-Version: 0.1.3
-Summary: Instant codebase map for AI agents — understand any project before making changes
-Author-email: Rajat Handa <handarajat111@gmail.com>
-License-Expression: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.0.0
-Provides-Extra: anthropic
-Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
-Provides-Extra: openai
-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"
-
-# AgenticStack
-
-Instant codebase map for AI agents — understand any project before making changes.
-
-## What it does
-
-AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
-
-- Where every model, view, serializer, and service lives
-- Which files to touch when making a specific change
-- Which models are exposed via API vs internal only
-- Step by step how-to guides using your actual file paths
-
-## Installation
-
-```bash
-pip install agenticstackfile
-```
-
-With AI support:
-
-```bash
-pip install 'agenticstackfile[openai]'
-pip install 'agenticstackfile[anthropic]'
-```
-
-## Usage
-
-```bash
-agenticstack init      # First time setup
-agenticstack update    # Refresh AgenticStack.txt
-```
-
-## Modes
-
-**Static mode** — no API key needed. Uses Python AST to analyze your codebase for free.
-
-**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation.
-
-## Configuration
-
-Edit `.agenticstack.ini` in your project root:
-
-```ini
-[agenticstack]
-model = default
-api_key = YOUR_API_KEY
-provider = anthropic
-output_file = AgenticStack.txt
-```
-
-## Supported providers
-
-- `anthropic` — Claude Sonnet, Haiku, Opus
-- `openai` — GPT-4o, GPT-4o-mini

agenticstackfile-0.1.3/README.md

@@ -1,55 +0,0 @@
-# AgenticStack
-
-Instant codebase map for AI agents — understand any project before making changes.
-
-## What it does
-
-AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
-
-- Where every model, view, serializer, and service lives
-- Which files to touch when making a specific change
-- Which models are exposed via API vs internal only
-- Step by step how-to guides using your actual file paths
-
-## Installation
-
-```bash
-pip install agenticstackfile
-```
-
-With AI support:
-
-```bash
-pip install 'agenticstackfile[openai]'
-pip install 'agenticstackfile[anthropic]'
-```
-
-## Usage
-
-```bash
-agenticstack init      # First time setup
-agenticstack update    # Refresh AgenticStack.txt
-```
-
-## Modes
-
-**Static mode** — no API key needed. Uses Python AST to analyze your codebase for free.
-
-**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation.
-
-## Configuration
-
-Edit `.agenticstack.ini` in your project root:
-
-```ini
-[agenticstack]
-model = default
-api_key = YOUR_API_KEY
-provider = anthropic
-output_file = AgenticStack.txt
-```
-
-## Supported providers
-
-- `anthropic` — Claude Sonnet, Haiku, Opus
-- `openai` — GPT-4o, GPT-4o-mini

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")

agenticstackfile-0.1.3/agenticstackfile.egg-info/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: agenticstackfile
-Version: 0.1.3
-Summary: Instant codebase map for AI agents — understand any project before making changes
-Author-email: Rajat Handa <handarajat111@gmail.com>
-License-Expression: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.0.0
-Provides-Extra: anthropic
-Requires-Dist: anthropic>=0.20.0; extra == "anthropic"
-Provides-Extra: openai
-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"
-
-# AgenticStack
-
-Instant codebase map for AI agents — understand any project before making changes.
-
-## What it does
-
-AgenticStack analyzes your Python project and generates `AgenticStack.txt` — a structured file that tells any AI agent:
-
-- Where every model, view, serializer, and service lives
-- Which files to touch when making a specific change
-- Which models are exposed via API vs internal only
-- Step by step how-to guides using your actual file paths
-
-## Installation
-
-```bash
-pip install agenticstackfile
-```
-
-With AI support:
-
-```bash
-pip install 'agenticstackfile[openai]'
-pip install 'agenticstackfile[anthropic]'
-```
-
-## Usage
-
-```bash
-agenticstack init      # First time setup
-agenticstack update    # Refresh AgenticStack.txt
-```
-
-## Modes
-
-**Static mode** — no API key needed. Uses Python AST to analyze your codebase for free.
-
-**AI mode** — provide an API key and Claude or GPT generates rich, detailed documentation.
-
-## Configuration
-
-Edit `.agenticstack.ini` in your project root:
-
-```ini
-[agenticstack]
-model = default
-api_key = YOUR_API_KEY
-provider = anthropic
-output_file = AgenticStack.txt
-```
-
-## Supported providers
-
-- `anthropic` — Claude Sonnet, Haiku, Opus
-- `openai` — GPT-4o, GPT-4o-mini