devops-bot-sdk 1.4.65__tar.gz → 1.4.67__tar.gz

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.4.65
+Version: 1.4.67
 Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
 Author: noumanaziz2128
 License-Expression: LicenseRef-Proprietary

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/devops_bot_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devops-bot-sdk
-Version: 1.4.65
+Version: 1.4.67
 Summary: DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app
 Author: noumanaziz2128
 License-Expression: LicenseRef-Proprietary

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devops-bot-sdk"
-version = "1.4.65"
+version = "1.4.67"
 description = "DevOps Bot Desktop SDK — thin client for the AgentOS Electron desktop app"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/sdk/__init__.py

@@ -1,6 +1,6 @@
 """AgentOS Desktop SDK — thin HTTPS/SSE client for the Electron app.
 
-Version: 1.4.65
+Version: 1.4.67
 
 Public surface:
   BackendClient.from_config()        — create client from ~/.agentos/config.toml
@@ -30,7 +30,7 @@ Rules:
   - All data egress through submit_webhook only
 """
 
-__version__ = "1.4.65"
+__version__ = "1.4.67"
 __author__  = "AgentOS"
 
 from sdk.client import BackendClient

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/sdk/client.py

@@ -58,7 +58,7 @@ def _notify_status(task_id: str, status: str) -> None:
             pass
 
 
-SDK_VERSION    = "1.4.65"
+SDK_VERSION    = "1.4.67"
 _POLL_INTERVAL = 3.0
 _POLL_TIMEOUT  = 600.0
 _ORCHESTRATE_TIMEOUT      = 2700.0  # 45 min — covers approval wait + VPS execution time

{devops_bot_sdk-1.4.65 → devops_bot_sdk-1.4.67}/sdk/ipc/handlers.py

@@ -594,6 +594,34 @@ def _epic_inherited_fields(task: dict) -> dict:
     return {k: v for k, v in fields.items() if v}
 
 
+# Lines that name a directory to WRITE the generated user stories into (distinct
+# from a code repo path). Matches story/file/folder/directory/mkdir/write hints
+# and skips repo lines (github URL / "path:").
+_STORIES_DIR_HINT = re.compile(
+    r"\b(user\s+stor|stories|mkdir|directory|folder|write|\.md)\b", re.I,
+)
+
+
+def _extract_stories_dir(text: str | None) -> str | None:
+    """A directory the instructions ask the user stories to be WRITTEN into, or None.
+
+    Scans lines that mention stories/files/a directory (but not code-repo lines that
+    carry a GitHub URL or a "path:" repo label) and returns the first filesystem path
+    found — e.g. "Create a new directory at /home/me/new_tasks and write the stories".
+    """
+    if not text:
+        return None
+    for line in text.splitlines():
+        low = line.lower()
+        if "github.com" in low or "path:" in low:
+            continue  # a code repo line, not a stories-output directory
+        if _STORIES_DIR_HINT.search(line):
+            p = _extract_path_from_text(line)
+            if p:
+                return p
+    return None
+
+
 # ── Ticket validation gate (Epics + USER-driven Stories) ────────────────────
 # A strict quality gate: before the bot actions an Epic or a USER-created Story it
 # checks the ticket meets the required standard. On failure it posts a harsh,
@@ -616,30 +644,42 @@ def _build_validation_prompt(kind: str, jira_key: str, summary: str,
         "Description:\n" + (_clip_text(description.strip()) if description and description.strip() else "(none provided)"),
         "Human Instructions:\n" + (human.strip() if human and human.strip() else "(none provided)"),
     ]
+    is_epic = kind == "epic"
     parts.append(
-        "Judge the ticket in the context of what it ACTUALLY asks for — it may be "
-        "software, documentation, analysis, Finance, HR or operations work. Do NOT "
-        "impose software requirements on a non-software ticket.\n\n"
+        "Judge the ticket for what it ACTUALLY asks for — software, documentation, "
+        "analysis, Finance, HR or operations. Do NOT impose requirements the ticket "
+        "does not need.\n\n"
         "A VALID ticket MUST have:\n"
         "- A clear, unambiguous goal and scope (no hand-waving).\n"
-        "- A clearly-defined deliverable or outcome, and — when a location matters — "
-        "WHERE to produce it (a folder path, a repository, or a document).\n"
-        "- Observable, testable acceptance criteria (or an equally concrete definition of done).\n"
-        "- ONLY IF the work requires CODE CHANGES to a software project: the target "
-        "repository link(s) and/or file path(s), the branch/PR convention, and "
-        "build/run/test steps. Do NOT demand these for documentation, content, analysis "
-        "or other non-code deliverables.\n"
-        + ("- Enough concrete detail to decompose into independent user stories.\n"
-           if kind == "epic" else
-           "- A clear 'As a <role>, I want <capability>, so that <benefit>' intent plus "
-           "testable acceptance criteria.\n")
+        "- A clearly-defined deliverable/outcome (and where to produce it when a "
+        "location matters).\n"
+        "- Observable acceptance criteria (or an equally concrete definition of done).\n"
+        + (
+            # EPIC: a decomposition container — NEVER require code-execution details.
+            "- Enough substance to DECOMPOSE into user stories.\n"
+            "IMPORTANT: this is an EPIC — a high-level container the system decomposes "
+            "into user stories. Do NOT require a repository URL, file paths, branch/PR "
+            "convention, or build/run/test commands at the epic level; those are "
+            "established LATER at the story/task stage, never in the epic. Even when the "
+            "epic describes software features, judge it ONLY on goal, scope, user "
+            "stories and epic-level acceptance criteria. NEVER reject an epic for missing "
+            "repository, branch, PR, build, or test details.\n"
+            if is_epic else
+            # STORY: repo details help but the PRD/coding stage grounds them.
+            "- A clear 'As a <role>, I want <capability>, so that <benefit>' intent plus "
+            "testable acceptance criteria.\n"
+            "For a code story, a target repo/path is helpful but NOT mandatory here — the "
+            "PRD/coding stage grounds it against the codebase. Do NOT reject solely for a "
+            "missing branch/PR convention or build/test steps.\n"
+        )
         + "- Any THIRD-PARTY INTEGRATION or human-effort dependency the work GENUINELY "
-        "needs (API keys, OAuth credentials, external accounts, secrets, manual "
-        "provisioning, DNS, billing) MUST be named WITH who provides it; if such a "
-        "REQUIRED dependency is undefined, REJECT.\n\n"
-        "A ticket that clearly states its deliverable and where to produce it is VALID "
-        "even without repository/branch details. Reject only for genuinely missing or "
-        "ambiguous information — not for absent software details the task does not need.\n\n"
+        "needs (API keys, OAuth credentials, external accounts, secrets, provisioning) "
+        "MUST be named WITH who provides it; if a REQUIRED dependency is undefined, REJECT.\n\n"
+        "Unrendered template placeholders — an EMPTY `{{...}}` or `<...>` with no real "
+        "content — are a valid reason to reject. But if a section contains real content "
+        "merely wrapped in stray markers, treat it as PRESENT, not missing.\n"
+        "Reject only for genuinely missing or ambiguous information — not for absent "
+        "execution details the ticket does not need at this stage.\n\n"
         "Output ONLY a fenced ```json block, nothing else:\n"
         "{\n"
         '  "valid": true or false,\n'
@@ -827,6 +867,38 @@ async def _handle_epic(
                 data={"current_step": f"  ↳ created To Do task: {fields['summary']}"},
             ).model_dump())
 
+    # 3b. Optionally ALSO write each story as a Markdown file to a directory named in
+    #     the instructions (e.g. "create /home/me/new_tasks and write the user stories
+    #     there"). This is IN ADDITION to the Story tickets. Best-effort — a file-write
+    #     failure never fails the Epic.
+    stories_dir = _extract_stories_dir(human)
+    if stories_dir:
+        from pathlib import Path
+        try:
+            d = Path(stories_dir).expanduser()
+            d.mkdir(parents=True, exist_ok=True)  # create from scratch
+            written = 0
+            for i, st in enumerate(stories[:_MAX_EPIC_STORIES], 1):
+                if not isinstance(st, dict) or not (st.get("summary") or "").strip():
+                    continue
+                title = str(st.get("summary", "")).strip()
+                slug = re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")[:50] or f"story-{i}"
+                content = f"# {title}\n\n{str(st.get('description', '') or '').strip()}\n"
+                (d / f"{i:02d}-{slug}.md").write_text(content, encoding="utf-8")
+                written += 1
+            await client.log_activity(f"Epic {jira_key}: wrote {written} user-story file(s) to {stories_dir}")
+            await send(Envelope(
+                type="step_update", thread_id=thread_id,
+                data={"jira_task_id": tid,
+                      "current_step": f"Epic {jira_key}: wrote {written} user-story file(s) to {stories_dir}"},
+            ).model_dump())
+        except Exception as exc:  # noqa: BLE001
+            await send(Envelope(
+                type="step_update", thread_id=thread_id,
+                data={"jira_task_id": tid,
+                      "current_step": f"Epic {jira_key}: could not write story files to {stories_dir} — {str(exc)[:120]}"},
+            ).model_dump())
+
     await client.log_activity(
         f"Epic {jira_key}: Done — created {len(created)}/{len(stories)} To Do user Story(ies)"
     )