jude-prompt-engine 0.1.0__tar.gz

jude_prompt_engine-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: jude-prompt-engine
+Version: 0.1.0
+Summary: Deterministic prompt compiler and optimizer for AI-driven code analysis
+Author-email: Aryan Walia <p0riya003@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/aryanwalia2003/jude
+Project-URL: Repository, https://github.com/aryanwalia2003/jude
+Project-URL: Issues, https://github.com/aryanwalia2003/jude/issues
+Project-URL: Documentation, https://github.com/aryanwalia2003/jude/tree/main/prompt-engine
+Keywords: prompt-engineering,ai-agents,code-analysis,deterministic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# jude-prompt-engine
+
+Deterministic prompt compiler and optimizer for AI-driven code analysis. Part of the Jude AI Infrastructure suite.
+
+## Installation
+
+```bash
+pip install jude-prompt-engine
+```
+
+## Quick Start
+
+```bash
+ai --help
+```
+
+## Features
+
+- **Deterministic Compilation** — Reproducible prompt generation
+- **Multi-mode Support** — strict, safe, deep modes for different use cases
+- **Ranking & Context** — Deterministic symbol retrieval with audit trails
+- **Output Validation** — Schema enforcement for structured outputs
+
+## Usage
+
+```bash
+# Basic prompt
+ai "debug why emit_sync is failing"
+
+# With specific mode
+ai --mode deep "analyze performance of scheduler"
+
+# Custom preset
+ai --preset code-review "check this function"
+```
+
+## Documentation
+
+Full documentation is available in the [main repository](https://github.com/aryanwalia2003/jude).

jude_prompt_engine-0.1.0/README.md

@@ -0,0 +1,39 @@
+# jude-prompt-engine
+
+Deterministic prompt compiler and optimizer for AI-driven code analysis. Part of the Jude AI Infrastructure suite.
+
+## Installation
+
+```bash
+pip install jude-prompt-engine
+```
+
+## Quick Start
+
+```bash
+ai --help
+```
+
+## Features
+
+- **Deterministic Compilation** — Reproducible prompt generation
+- **Multi-mode Support** — strict, safe, deep modes for different use cases
+- **Ranking & Context** — Deterministic symbol retrieval with audit trails
+- **Output Validation** — Schema enforcement for structured outputs
+
+## Usage
+
+```bash
+# Basic prompt
+ai "debug why emit_sync is failing"
+
+# With specific mode
+ai --mode deep "analyze performance of scheduler"
+
+# Custom preset
+ai --preset code-review "check this function"
+```
+
+## Documentation
+
+Full documentation is available in the [main repository](https://github.com/aryanwalia2003/jude).

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: jude-prompt-engine
+Version: 0.1.0
+Summary: Deterministic prompt compiler and optimizer for AI-driven code analysis
+Author-email: Aryan Walia <p0riya003@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/aryanwalia2003/jude
+Project-URL: Repository, https://github.com/aryanwalia2003/jude
+Project-URL: Issues, https://github.com/aryanwalia2003/jude/issues
+Project-URL: Documentation, https://github.com/aryanwalia2003/jude/tree/main/prompt-engine
+Keywords: prompt-engineering,ai-agents,code-analysis,deterministic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# jude-prompt-engine
+
+Deterministic prompt compiler and optimizer for AI-driven code analysis. Part of the Jude AI Infrastructure suite.
+
+## Installation
+
+```bash
+pip install jude-prompt-engine
+```
+
+## Quick Start
+
+```bash
+ai --help
+```
+
+## Features
+
+- **Deterministic Compilation** — Reproducible prompt generation
+- **Multi-mode Support** — strict, safe, deep modes for different use cases
+- **Ranking & Context** — Deterministic symbol retrieval with audit trails
+- **Output Validation** — Schema enforcement for structured outputs
+
+## Usage
+
+```bash
+# Basic prompt
+ai "debug why emit_sync is failing"
+
+# With specific mode
+ai --mode deep "analyze performance of scheduler"
+
+# Custom preset
+ai --preset code-review "check this function"
+```
+
+## Documentation
+
+Full documentation is available in the [main repository](https://github.com/aryanwalia2003/jude).

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+README.md
+pyproject.toml
+jude_prompt_engine.egg-info/PKG-INFO
+jude_prompt_engine.egg-info/SOURCES.txt
+jude_prompt_engine.egg-info/dependency_links.txt
+jude_prompt_engine.egg-info/entry_points.txt
+jude_prompt_engine.egg-info/requires.txt
+jude_prompt_engine.egg-info/top_level.txt
+prompt_engine/__init__.py
+prompt_engine/budget.py
+prompt_engine/cli.py
+prompt_engine/compiler.py
+prompt_engine/config.py
+prompt_engine/contracts.py
+prompt_engine/intent.py
+prompt_engine/output_serializer.py
+prompt_engine/policy.py
+prompt_engine/presets.py
+prompt_engine/retrieval.py
+prompt_engine/schemas.py
+prompt_engine/task.py
+prompt_engine/taxonomy.py
+prompt_engine/validator.py
+tests/test_retrieval.py
+tests/test_schemas.py

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ai = prompt_engine.cli:app

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/requires.txt

@@ -0,0 +1,5 @@
+typer>=0.9
+rich>=13
+
+[dev]
+pytest>=7

jude_prompt_engine-0.1.0/jude_prompt_engine.egg-info/top_level.txt

@@ -0,0 +1 @@
+prompt_engine

jude_prompt_engine-0.1.0/prompt_engine/__init__.py

@@ -0,0 +1,15 @@
+"""Deterministic prompt orchestration engine for AI-assisted coding."""
+
+from .taxonomy import TaskType, SubType, Mode, Constraint, RiskLevel
+from .task import Task, RetrievalPlan, PromptPlan, PromptBlock, VerificationPlan, ContextBudget
+from .intent import classify, IntentResult
+from .compiler import compile_task
+from .config import load_config, EngineConfig
+
+__all__ = [
+    "TaskType", "SubType", "Mode", "Constraint", "RiskLevel",
+    "Task", "RetrievalPlan", "PromptPlan", "PromptBlock", "VerificationPlan", "ContextBudget",
+    "classify", "IntentResult",
+    "compile_task",
+    "load_config", "EngineConfig",
+]

jude_prompt_engine-0.1.0/prompt_engine/budget.py

@@ -0,0 +1,85 @@
+"""Context budget management — token allocation and prioritization."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+from .task import ContextBudget, PromptBlock, PromptPlan
+
+
+_CHARS_PER_TOKEN = 4
+
+
+def estimate_tokens(text: str) -> int:
+    return max(1, len(text) // _CHARS_PER_TOKEN)
+
+
+@dataclass
+class BudgetAllocation:
+    system_policy: int
+    task_block: int
+    constraints: int
+    context_placeholder: int
+    output_contract: int
+    verification: int
+
+    @property
+    def total(self) -> int:
+        return (
+            self.system_policy
+            + self.task_block
+            + self.constraints
+            + self.context_placeholder
+            + self.output_contract
+            + self.verification
+        )
+
+
+def allocate(budget: ContextBudget) -> BudgetAllocation:
+    """Distribute token budget across prompt sections."""
+    total = budget.max_tokens
+    return BudgetAllocation(
+        system_policy=int(total * 0.08),
+        task_block=int(total * 0.05),
+        constraints=int(total * 0.10),
+        context_placeholder=int(total * 0.55),  # largest — actual repo context
+        output_contract=int(total * 0.12),
+        verification=int(total * 0.10),
+    )
+
+
+def enforce_budget(plan: PromptPlan) -> PromptPlan:
+    """Mark low-priority blocks as excluded if over budget."""
+    if not plan.budget:
+        return plan
+
+    max_tokens = plan.budget.max_tokens
+    included = sorted(
+        [b for b in plan.blocks if b.included],
+        key=lambda b: b.priority,
+    )
+    running = 0
+    for block in included:
+        if running + block.token_estimate > max_tokens:
+            block.included = False
+            block.omit_reason = f"budget exceeded ({running}/{max_tokens} used)"
+        else:
+            running += block.token_estimate
+
+    return plan
+
+
+def compression_summary(plan: PromptPlan) -> list[str]:
+    """Describe what was included vs excluded and why."""
+    lines = []
+    for b in plan.blocks:
+        status = "✓" if b.included else "✗"
+        reason = f"  [{b.omit_reason}]" if b.omit_reason else ""
+        lines.append(f"  {status} {b.role:<22} ~{b.token_estimate:>4} tokens{reason}")
+    if plan.budget:
+        used = plan.total_tokens()
+        cap = plan.budget.max_tokens
+        pct = int(used / cap * 100)
+        lines.append(f"\n  Total: {used}/{cap} tokens ({pct}%)")
+    return lines