delimit-cli 4.1.53 → 4.2.0

package/gateway/ai/workers/outreach_drafter.py

@@ -0,0 +1,161 @@
+"""Outreach-drafter worker (LED-976).
+
+Takes an audit-program target from the signal corpus or ledger,
+runs delimit_lint against the target's spec if available, and drafts
+a GitHub issue body per the AUDIT_PROGRAM.md template. Cannot post —
+produces a work-order for founder approval.
+
+Bounded to: delimit_lint, delimit_diff, delimit_sense, read_file.
+Cannot: write files, post issues, commit, push.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Dict
+
+from ai.workers.base import Worker, WorkerResult
+from ai.work_order import create_work_order
+
+
+class OutreachDrafterWorker(Worker):
+    worker_type = "outreach_drafter"
+    description = "Drafts governance-outreach GitHub issues"
+
+    def execute(self, ledger_item: Dict[str, Any]) -> WorkerResult:
+        item_id = ledger_item.get("id", "?")
+        title = ledger_item.get("title", "")
+        context = ledger_item.get("context", "")
+        description = ledger_item.get("description", "")
+
+        # Extract repo info
+        import re
+        repo = ""
+        for field in [context, description, title]:
+            match = re.search(r'([\w.-]+/[\w.-]+)', field)
+            if match and "/" in match.group(1):
+                candidate = match.group(1)
+                # Skip our own repos
+                if not candidate.startswith("delimit-ai/"):
+                    repo = candidate
+                    break
+
+        if not repo:
+            return WorkerResult(
+                worker_type=self.worker_type,
+                ledger_item_id=item_id,
+                success=False,
+                error="Could not extract target repo from ledger item",
+            )
+
+        # Draft the issue body per AUDIT_PROGRAM.md template
+        issue_title = f"Suggestion: CI check for API schema drift"
+        issue_body = f"""## Context
+
+This repo maintains an API specification that downstream consumers depend on.
+Breaking changes in API contracts (endpoint removal, type changes, required
+parameter additions) can cause silent integration failures for consumers.
+
+## Suggestion
+
+Add an advisory CI check that diffs the base branch spec against PRs.
+A single workflow file:
+
+```yaml
+name: API Schema Check
+on:
+  pull_request:
+    paths:
+      - 'api/**'
+      - '*.yaml'
+      - '*.json'
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: delimit-ai/delimit-action@v1
+        with:
+          spec: openapi.yaml
+```
+
+This diffs the base branch spec against the PR and posts a comment
+identifying breaking vs non-breaking changes with semver classification.
+Advisory only — never blocks merges. Teams can upgrade to enforcement later.
+
+## What it catches
+
+| DGF Control | Detection | Severity |
+|---|---|---|
+| DGF-BC-001 | Endpoint removal | High |
+| DGF-BC-002 | Required parameter added | High |
+| DGF-BC-003 | Required response field removed | High |
+| DGF-BC-004 | Type changed | High |
+| DGF-BC-005 | Enum value removed | High |
+| + 10 more | See [DGF v0.1.0](https://github.com/delimit-ai/governance-framework) | — |
+
+Zero config, no API keys, runs in under 30 seconds.
+[Live demo](https://github.com/delimit-ai/delimit-action-demo/pull/2).
+
+Happy to open a PR if there's interest.
+"""
+
+        # Emit a structured action the executor can run after founder
+        # approval. Keeps the human steps above for readability; the
+        # executor uses this typed list to actually post the issue.
+        executable = [
+            {
+                "action": "gh_issue_create",
+                "params": {
+                    "repo": repo,
+                    "title": issue_title,
+                    "body": issue_body.strip(),
+                },
+            }
+        ]
+
+        # Create the work order
+        wo = create_work_order(
+            title=f"Outreach: Open governance issue on {repo}",
+            goal=f"Open a GitHub issue on {repo} suggesting API schema CI check",
+            context=f"Source: {item_id}. Per AUDIT_PROGRAM.md playbook. Must pass pre-outreach capability-test gate: run delimit lint against the target's spec before claiming detection.",
+            steps=[
+                f"Verify {repo} has a checked-in API spec (search for openapi.yaml, swagger.yaml, api.json, schema.json)",
+                f"Run: delimit lint <old_spec> <new_spec> on a recent PR that changed the spec (proves the tool works on their spec)",
+                f"If lint works, open the issue:",
+                f"```",
+                f"gh issue create --repo {repo} \\",
+                f"  --title '{issue_title}' \\",
+                f"  --body-file /dev/stdin <<'BODY'",
+                issue_body.strip(),
+                "BODY",
+                f"```",
+                "Wait for maintainer response (do NOT open a PR immediately)",
+            ],
+            acceptance_criteria=[
+                f"Pre-outreach capability test passes (delimit lint works on {repo}'s spec)",
+                f"Issue opened on {repo} matching AUDIT_PROGRAM.md format",
+                "No capability claims the tool can't back",
+                "Staggered timing (not batch-submitted with other issues)",
+            ],
+            ledger_item_id=item_id,
+            priority=ledger_item.get("priority", "P1"),
+            tools_needed=["gh", "delimit"],
+            estimated_minutes=20,
+            worker_type=self.worker_type,
+            executable_actions=executable,
+        )
+
+        return WorkerResult(
+            worker_type=self.worker_type,
+            ledger_item_id=item_id,
+            success=True,
+            artifact_path=wo.get("filepath", ""),
+            artifact_preview=wo.get("preview", "")[:300],
+            work_order_id=wo.get("id", ""),
+        )

package/gateway/ai/workers/pr_drafter.py

@@ -0,0 +1,148 @@
+"""PR-drafter worker (LED-975).
+
+Takes a ledger item describing an outreach target (repo with checked-in
+spec) and produces a draft PR body + workflow YAML as a work-order
+artifact the founder can copy-paste into a gh pr create command.
+
+Bounded to: delimit_lint, delimit_diff, delimit_spec_health, read_file.
+Cannot: write files, commit, push, post comments.
+"""
+
+from __future__ import annotations
+
+import json
+from typing import Any, Dict
+
+from ai.workers.base import Worker, WorkerResult
+from ai.work_order import create_work_order
+
+
+class PRDrafterWorker(Worker):
+    worker_type = "pr_drafter"
+    description = "Drafts PR bodies for governance check workflows"
+
+    def execute(self, ledger_item: Dict[str, Any]) -> WorkerResult:
+        item_id = ledger_item.get("id", "?")
+        title = ledger_item.get("title", "")
+        context = ledger_item.get("context", "")
+        description = ledger_item.get("description", "")
+
+        # Extract repo info from the ledger item
+        repo = ""
+        spec_path = ""
+        for field in [context, description, title]:
+            # Look for owner/repo pattern
+            import re
+            match = re.search(r'([\w.-]+/[\w.-]+)', field)
+            if match and "/" in match.group(1):
+                repo = match.group(1)
+                break
+
+        if not repo:
+            return WorkerResult(
+                worker_type=self.worker_type,
+                ledger_item_id=item_id,
+                success=False,
+                error="Could not extract repo from ledger item",
+            )
+
+        # Try to detect the spec path
+        common_spec_paths = [
+            "api/openapi.yaml",
+            "api/openapi.yml",
+            "api/swagger.yaml",
+            "api/swagger.yml",
+            "openapi.yaml",
+            "openapi.yml",
+            "swagger.yaml",
+            "swagger.yml",
+            "api/v2.0/swagger.yaml",
+            "schema.json",
+            "api.json",
+        ]
+        spec_path = common_spec_paths[0]  # default, will be refined
+
+        # Generate the workflow YAML
+        workflow_yaml = f"""name: API Schema Check
+on:
+  pull_request:
+    paths:
+      - '{spec_path.rsplit("/", 1)[0] if "/" in spec_path else "."}/**'
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: delimit-ai/delimit-action@v1
+        with:
+          spec: {spec_path}
+"""
+
+        # Generate the PR body
+        pr_body = f"""## Summary
+
+Add an API schema drift check for `{spec_path}`. Advisory only — never blocks merges.
+
+The action diffs the base branch spec against the PR and posts a comment identifying breaking vs non-breaking changes with semver classification. Detects 27 change types including endpoint removal, type changes, required parameter additions, and enum value removals.
+
+## Changes
+
+- Add `.github/workflows/api-schema-check.yml`
+
+## Details
+
+- Scoped to `{spec_path.rsplit("/", 1)[0] if "/" in spec_path else "."}/**` — only runs on PRs that modify the spec
+- Zero config, no API keys, runs in under 30 seconds
+- [Live demo](https://github.com/delimit-ai/delimit-action-demo/pull/2) showing 23 breaking changes detected
+
+## References
+
+- [Delimit Governance Framework (DGF)](https://github.com/delimit-ai/governance-framework) — 15 citeable controls
+- [Delimit Action on Marketplace](https://github.com/marketplace/actions/delimit-api-governance)
+"""
+
+        # Create the work order
+        wo = create_work_order(
+            title=f"PR: Add governance check to {repo}",
+            goal=f"Open a PR on {repo} adding .github/workflows/api-schema-check.yml scoped to {spec_path}",
+            context=f"Source ledger item: {item_id}. Target: {repo}.",
+            steps=[
+                f"Fork {repo} (if not already forked)",
+                f"Create branch: add-api-schema-check",
+                f"Add file .github/workflows/api-schema-check.yml with content below",
+                "```yaml",
+                workflow_yaml.strip(),
+                "```",
+                f"Commit with: git commit -s -m 'ci: add API schema drift check for {spec_path}'",
+                f"Push and open PR with body below",
+                "```",
+                pr_body.strip(),
+                "```",
+                f"Or one-liner: gh pr create --title 'ci: add API schema drift check' --body-file <(cat <<'BODY'\n{pr_body.strip()}\nBODY\n)",
+            ],
+            acceptance_criteria=[
+                f"PR opened on {repo}",
+                "Workflow file is advisory-only (never blocks merges)",
+                "DCO sign-off included",
+                "Maintainer response within 7 days",
+            ],
+            ledger_item_id=item_id,
+            priority=ledger_item.get("priority", "P1"),
+            tools_needed=["gh", "git"],
+            estimated_minutes=15,
+            worker_type=self.worker_type,
+        )
+
+        return WorkerResult(
+            worker_type=self.worker_type,
+            ledger_item_id=item_id,
+            success=True,
+            artifact_path=wo.get("filepath", ""),
+            artifact_preview=wo.get("preview", "")[:300],
+            work_order_id=wo.get("id", ""),
+        )

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "4.1.53",
+  "version": "4.2.0",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [
@@ -11,17 +11,30 @@
     "gateway/",
     "!gateway/ai/social_target.py",
     "!gateway/ai/social.py",
+    "!gateway/ai/social_daemon.py",
+    "!gateway/ai/social_cache.py",
     "!gateway/ai/founding_users.py",
     "!gateway/ai/inbox_daemon.py",
+    "!gateway/ai/inbox_daemon_runner.py",
     "!gateway/ai/deliberation.py",
     "!gateway/ai/dv_mention_tracker.py",
     "!gateway/ai/sensor_twttr.py",
     "!gateway/ai/tweet_corpus.py",
+    "!gateway/ai/tweet_corpus_schema.sql",
     "!gateway/ai/twttr241_budget.py",
     "!gateway/ai/wireintel_x.py",
     "!gateway/ai/content_intel.py",
     "!gateway/ai/loop_daemon.py",
+    "!gateway/ai/loop_engine.py",
     "scripts/",
+    "!scripts/crosspost_devto.py",
+    "!scripts/repo_targeting.py",
+    "!scripts/outreach_report_generator.py",
+    "!scripts/demo-v420.sh",
+    "!scripts/demo-v420-clean.sh",
+    "!scripts/demo-v420-deliberation.sh",
+    "!scripts/sync-gateway.sh",
+    "!gateway/ai/continuity.py",
     "server.json",
     "README.md",
     "LICENSE",