instructvault 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

instructvault/bundle.py

@@ -29,22 +29,32 @@ def collect_prompts(repo_root: Path, prompts_dir: Path, ref: Optional[str]) -> L
     store = PromptStore(repo_root)
     prompts: List[BundlePrompt] = []
     if ref is None:
+        if not prompts_dir.exists():
+            raise FileNotFoundError(f"Prompts directory not found: {prompts_dir}")
+        try:
+            prompts_dir.relative_to(repo_root)
+        except Exception:
+            raise ValueError("prompts_dir must be within repo_root")
         for p in sorted(prompts_dir.rglob("*.prompt.y*ml")):
             rel_path = p.relative_to(repo_root).as_posix()
-            spec = load_prompt_spec(p.read_text(encoding="utf-8"))
+            spec = load_prompt_spec(p.read_text(encoding="utf-8"), allow_no_tests=True)
             prompts.append(BundlePrompt(rel_path, spec))
         for p in sorted(prompts_dir.rglob("*.prompt.json")):
             rel_path = p.relative_to(repo_root).as_posix()
-            spec = load_prompt_spec(p.read_text(encoding="utf-8"))
+            spec = load_prompt_spec(p.read_text(encoding="utf-8"), allow_no_tests=True)
             prompts.append(BundlePrompt(rel_path, spec))
+        if not prompts:
+            raise ValueError(f"No prompt files found in {prompts_dir}")
         return prompts
 
     rel_dir = prompts_dir.relative_to(repo_root).as_posix()
     for rel_path in _list_files_at_ref(repo_root, ref, rel_dir):
         if not _is_prompt_file(rel_path):
             continue
-        spec = load_prompt_spec(store.read_text(rel_path, ref=ref))
+        spec = load_prompt_spec(store.read_text(rel_path, ref=ref), allow_no_tests=True)
         prompts.append(BundlePrompt(rel_path, spec))
+    if not prompts:
+        raise ValueError(f"No prompt files found at ref {ref} in {rel_dir}")
     return prompts
 
 def write_bundle(out_path: Path, *, repo_root: Path, prompts_dir: Path, ref: Optional[str]) -> None:
@@ -59,4 +69,3 @@ def write_bundle(out_path: Path, *, repo_root: Path, prompts_dir: Path, ref: Opt
     }
     out_path.parent.mkdir(parents=True, exist_ok=True)
     out_path.write_text(json.dumps(payload, indent=2), encoding="utf-8")
-

instructvault/cli.py

@@ -39,7 +39,7 @@ def validate(path: Path = typer.Argument(...),
     results = []
     for f in files:
         try:
-            spec = load_prompt_spec(f.read_text(encoding="utf-8"))
+            spec = load_prompt_spec(f.read_text(encoding="utf-8"), allow_no_tests=False)
             try:
                 rel_path = f.relative_to(repo).as_posix()
             except ValueError:
@@ -65,10 +65,14 @@ def render(prompt_path: str = typer.Argument(...),
            vars_json: str = typer.Option("{}", "--vars"),
            ref: Optional[str] = typer.Option(None, "--ref"),
            repo: Path = typer.Option(Path("."), "--repo"),
-           json_out: bool = typer.Option(False, "--json")):
+           json_out: bool = typer.Option(False, "--json"),
+           allow_no_tests: bool = typer.Option(False, "--allow-no-tests")):
     store = PromptStore(repo_root=repo)
-    spec = load_prompt_spec(store.read_text(prompt_path, ref=ref))
-    vars_dict = json.loads(vars_json)
+    spec = load_prompt_spec(store.read_text(prompt_path, ref=ref), allow_no_tests=allow_no_tests)
+    try:
+        vars_dict = json.loads(vars_json)
+    except Exception:
+        raise typer.BadParameter("Invalid JSON for --vars")
     check_required_vars(spec, vars_dict)
     msgs = render_messages(spec, vars_dict)
     if json_out:
@@ -121,7 +125,7 @@ def eval(prompt_path: str = typer.Argument(...),
          repo: Path = typer.Option(Path("."), "--repo"),
          json_out: bool = typer.Option(False, "--json")):
     store = PromptStore(repo_root=repo)
-    spec = load_prompt_spec(store.read_text(prompt_path, ref=ref))
+    spec = load_prompt_spec(store.read_text(prompt_path, ref=ref), allow_no_tests=False)
 
     ok1, r1 = run_inline_tests(spec)
     results = list(r1)

instructvault/io.py

@@ -4,13 +4,16 @@ import json
 import yaml
 from .spec import DatasetRow, PromptSpec
 
-def load_prompt_spec(yaml_text: str) -> PromptSpec:
+def load_prompt_spec(yaml_text: str, *, allow_no_tests: bool = True) -> PromptSpec:
     text = yaml_text.strip()
     if text.startswith("{") or text.startswith("["):
-        data: Dict[str, Any] = json.loads(text) if text else {}
+        try:
+            data: Dict[str, Any] = json.loads(text) if text else {}
+        except Exception:
+            data = yaml.safe_load(yaml_text) or {}
     else:
         data = yaml.safe_load(yaml_text) or {}
-    return PromptSpec.model_validate(data)
+    return PromptSpec.model_validate(data, context={"allow_no_tests": allow_no_tests})
 
 def load_dataset_jsonl(text: str) -> List[DatasetRow]:
     rows: List[DatasetRow] = []

instructvault/sdk.py

@@ -19,12 +19,14 @@ class InstructVault:
 
     def load_prompt(self, prompt_path: str, ref: Optional[str] = None) -> PromptSpec:
         if self.bundle is not None:
+            if ref is not None:
+                raise ValueError("ref is not supported when using bundle_path")
             if prompt_path not in self.bundle:
                 raise FileNotFoundError(f"Prompt not found in bundle: {prompt_path}")
             return self.bundle[prompt_path]
         if self.store is None:
             raise ValueError("No repo_root configured")
-        return load_prompt_spec(self.store.read_text(prompt_path, ref=ref))
+        return load_prompt_spec(self.store.read_text(prompt_path, ref=ref), allow_no_tests=True)
     def render(self, prompt_path: str, vars: Dict[str, Any], ref: Optional[str] = None) -> List[PromptMessage]:
         spec = self.load_prompt(prompt_path, ref=ref)
         check_required_vars(spec, vars)

instructvault/spec.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 from typing import Any, Dict, List, Literal, Optional
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, model_validator
 
 Role = Literal["system", "user", "assistant", "tool"]
 
@@ -25,6 +25,11 @@ class AssertSpec(BaseModel):
     contains_any: Optional[List[str]] = None
     contains_all: Optional[List[str]] = None
     not_contains: Optional[List[str]] = None
+    @model_validator(mode="after")
+    def _require_one(self) -> "AssertSpec":
+        if not (self.contains_any or self.contains_all or self.not_contains):
+            raise ValueError("assert must include at least one of contains_any, contains_all, not_contains")
+        return self
 
 class PromptTest(BaseModel):
     model_config = ConfigDict(extra="forbid")
@@ -42,6 +47,17 @@ class PromptSpec(BaseModel):
     messages: List[PromptMessage]
     tests: List[PromptTest] = Field(default_factory=list)
 
+    @model_validator(mode="after")
+    def _require_tests(self) -> "PromptSpec":
+        allow_no_tests = False
+        try:
+            allow_no_tests = bool(self.__pydantic_context__.get("allow_no_tests"))
+        except Exception:
+            allow_no_tests = False
+        if not self.tests and not allow_no_tests:
+            raise ValueError("prompt must include at least one test")
+        return self
+
 class DatasetRow(BaseModel):
     model_config = ConfigDict(extra="forbid")
     vars: Dict[str, Any] = Field(default_factory=dict)

{instructvault-0.2.1.dist-info → instructvault-0.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: instructvault
-Version: 0.2.1
+Version: 0.2.3
 Summary: Git-first prompt registry + CI evals + lightweight runtime SDK (ivault).
 Project-URL: Homepage, https://github.com/05satyam/instruct_vault
 Project-URL: Repository, https://github.com/05satyam/instruct_vault
@@ -14,6 +14,7 @@ Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.7
 Requires-Dist: typer>=0.12
 Provides-Extra: dev
+Requires-Dist: httpx>=0.27; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
@@ -48,6 +49,10 @@ flowchart LR
 Enterprises already have Git + PR reviews + CI/CD. Prompts usually don’t.
 InstructVault brings **prompt‑as‑code** without requiring a server, database, or platform.
 
+## Vision
+Short version: Git‑first prompts with CI governance and zero‑latency runtime.  
+Full vision: `docs/vision.md`
+
 ## Features
 - ✅ Git‑native versioning (tags/SHAs = releases)
 - ✅ CLI‑first (`init`, `validate`, `render`, `eval`, `diff`, `resolve`, `bundle`)
@@ -128,6 +133,10 @@ ivault render prompts/support_reply.prompt.yml --vars '{"ticket_text":"My app cr
 ivault eval prompts/support_reply.prompt.yml --dataset datasets/support_cases.jsonl --report out/report.json --junit out/junit.xml
 ```
 
+Note: Prompts must include at least one inline test. Datasets are optional.
+Migration tip: if you need to render a prompt that doesn’t yet include tests, use
+`ivault render --allow-no-tests` or add a minimal test first.
+
 ### 5) Version prompts with tags
 ```bash
 git add prompts datasets
@@ -176,7 +185,17 @@ export IVAULT_REPO_ROOT=/path/to/your/repo
 PYTHONPATH=. uvicorn ivault_playground.app:app --reload
 ```
 
+![Playground screenshot](docs/assets/playground.png)
+
+Optional auth:
+```bash
+export IVAULT_PLAYGROUND_API_KEY=your-secret
+```
+Then send `x-ivault-api-key` in requests (or keep it behind your org gateway).
+If you don’t set the env var, no auth is required.
+
 ## Docs
+- `docs/vision.md`
 - `docs/governance.md`
 - `docs/ci.md`
 - `docs/playground.md`

instructvault-0.2.3.dist-info/RECORD

@@ -0,0 +1,17 @@
+instructvault/__init__.py,sha256=cg7j0qh6W84D-K0uSOLKKAP2JquW4NRXwZRDDLk5E18,59
+instructvault/bundle.py,sha256=6bfHNxJsE3zuZBLX5ZiMAhn1Dw6BnFHRa55fN6XIPRI,3008
+instructvault/cli.py,sha256=v5vP-sgVpXRs-YGvxH8VWIarFqUD1IsXdB9lseaFJDA,6310
+instructvault/diff.py,sha256=vz_vmKDXasNFoVKHCk2u_TsboHk1BdwvX0wCnJI1ATQ,252
+instructvault/eval.py,sha256=-yrFHCEUrONvzfKLP8s_RktFU74Ergp9tQJvzfrMR9s,1949
+instructvault/io.py,sha256=n1yQfiy93Duz-8tJ_HpbCEq8MUn2jlLpSmUY6XBg8G4,1037
+instructvault/junit.py,sha256=sIEcIiGD3Xk6uCYjnE5p_07j8dPoS_RAc2eoy3BIBeQ,1133
+instructvault/render.py,sha256=vcVnqIXGytskZEKbUofoKgIVflQSYhsmdpEtZs1X19A,919
+instructvault/scaffold.py,sha256=f5gwXE3dUPuJYTedZRqBs8w5SQEgt1dgDSuqW2dxrMg,1685
+instructvault/sdk.py,sha256=abqFrmc9Q5LUqC_ZrwM12DlpTZZkXqRuzN0T2x9lqqY,1727
+instructvault/spec.py,sha256=ZtVXosHy0f3hRB5CP9xbVzSdW8fDnf0-AR46ehG9-MA,2450
+instructvault/store.py,sha256=NhN49w7xrkeij0lQDr-CEdANYLpNVBXumv_cKqLmiYY,1056
+instructvault-0.2.3.dist-info/METADATA,sha256=1fSmJLHruAYXuZpJa6AbDVSDaG8SLp8_lrxlH3OHaEM,6205
+instructvault-0.2.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+instructvault-0.2.3.dist-info/entry_points.txt,sha256=cdcMJQwBk9c95LwfN2W6x2xO43FwPjhfV3jHE7TTuHg,49
+instructvault-0.2.3.dist-info/licenses/LICENSE,sha256=VFbCvIsyizmkz4NrZPMdcPhyRK5uM0HhAjv3GBUbb7Y,135
+instructvault-0.2.3.dist-info/RECORD,,

instructvault-0.2.1.dist-info/RECORD

@@ -1,17 +0,0 @@
-instructvault/__init__.py,sha256=cg7j0qh6W84D-K0uSOLKKAP2JquW4NRXwZRDDLk5E18,59
-instructvault/bundle.py,sha256=gXOqjpza_8MrYJjJVCzBJKHbO78bXkAbqPUjKnS_6Nk,2478
-instructvault/cli.py,sha256=2ylpvw-GHmZdIUVS3AoepWcQy6RG9QAwqVEQaCFG60o,6065
-instructvault/diff.py,sha256=vz_vmKDXasNFoVKHCk2u_TsboHk1BdwvX0wCnJI1ATQ,252
-instructvault/eval.py,sha256=-yrFHCEUrONvzfKLP8s_RktFU74Ergp9tQJvzfrMR9s,1949
-instructvault/io.py,sha256=mxoNp6SXbFoty22fzrbf7z-B5Nlw0XjgWphK0awA1S8,867
-instructvault/junit.py,sha256=sIEcIiGD3Xk6uCYjnE5p_07j8dPoS_RAc2eoy3BIBeQ,1133
-instructvault/render.py,sha256=vcVnqIXGytskZEKbUofoKgIVflQSYhsmdpEtZs1X19A,919
-instructvault/scaffold.py,sha256=f5gwXE3dUPuJYTedZRqBs8w5SQEgt1dgDSuqW2dxrMg,1685
-instructvault/sdk.py,sha256=JpEik6AZof2cIG-4GO-mdWwZe7w2rwq45jKawwfstsQ,1594
-instructvault/spec.py,sha256=xRkcVjMnoKECLaAfjQHiGgQVMdZ_KvNzf-K-j6DQ6k0,1737
-instructvault/store.py,sha256=NhN49w7xrkeij0lQDr-CEdANYLpNVBXumv_cKqLmiYY,1056
-instructvault-0.2.1.dist-info/METADATA,sha256=rUEeRQAC23afX9UKccIqNKnGxCbKAmFaSQmnQxIaJew,5536
-instructvault-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-instructvault-0.2.1.dist-info/entry_points.txt,sha256=cdcMJQwBk9c95LwfN2W6x2xO43FwPjhfV3jHE7TTuHg,49
-instructvault-0.2.1.dist-info/licenses/LICENSE,sha256=VFbCvIsyizmkz4NrZPMdcPhyRK5uM0HhAjv3GBUbb7Y,135
-instructvault-0.2.1.dist-info/RECORD,,