delimit-cli 3.15.7 → 3.15.9

package/gateway/ai/server.py

@@ -3684,6 +3684,19 @@ def delimit_swarm(action: str = "status", venture: str = "",
         return _with_next_steps("swarm", _safe_call(
             check_namespace_access, agent_id=agent_id, target_path=target_path, action=access_action,
         ))
+    if action == "metric":
+        from ai.swarm import record_metric
+        return _with_next_steps("swarm", _safe_call(
+            record_metric, venture=venture, metric_type=access_action, note=target_path,
+        ))
+    if action == "metrics":
+        from ai.swarm import get_metrics
+        return _with_next_steps("swarm", _safe_call(get_metrics, venture=venture))
+    if action == "docs_check":
+        from ai.swarm import check_docs_freshness
+        return _with_next_steps("swarm", _safe_call(
+            check_docs_freshness, project_path=repo_path or ".",
+        ))
     return _with_next_steps("swarm", _safe_call(get_swarm_status))
 
 

package/gateway/ai/swarm.py

@@ -395,3 +395,198 @@ Medium alerts: prompt drift, model errors, credit exhaustion.
 def get_usage_guide() -> Dict[str, Any]:
     """Get the swarm usage guide."""
     return {"guide": USAGE_GUIDE, "version": "1.2"}
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  LED-278: GTM Tracking — speed, revenue, venture launches
+# ═══════════════════════════════════════════════════════════════════════
+
+METRICS_FILE = SWARM_DIR / "metrics.json"
+
+
+def _load_metrics() -> Dict[str, Any]:
+    if not METRICS_FILE.exists():
+        return {"daily": {}, "ventures": {}}
+    try:
+        return json.loads(METRICS_FILE.read_text())
+    except (json.JSONDecodeError, OSError):
+        return {"daily": {}, "ventures": {}}
+
+
+def _save_metrics(metrics: Dict[str, Any]):
+    _ensure_dir()
+    METRICS_FILE.write_text(json.dumps(metrics, indent=2))
+
+
+def record_metric(
+    venture: str,
+    metric_type: str,
+    value: float = 1.0,
+    note: str = "",
+) -> Dict[str, Any]:
+    """Record a GTM metric for tracking swarm performance.
+
+    Metric types: tasks_completed, deploy_count, revenue, launch_event,
+                  outreach_sent, user_signup, feature_shipped.
+    """
+    if not venture or not metric_type:
+        return {"error": "venture and metric_type required"}
+
+    metrics = _load_metrics()
+    today = time.strftime("%Y-%m-%d")
+
+    # Daily tracking
+    if today not in metrics["daily"]:
+        metrics["daily"][today] = {}
+    day = metrics["daily"][today]
+    key = f"{venture}:{metric_type}"
+    day[key] = day.get(key, 0) + value
+
+    # Venture totals
+    if venture not in metrics["ventures"]:
+        metrics["ventures"][venture] = {}
+    vtotals = metrics["ventures"][venture]
+    vtotals[metric_type] = vtotals.get(metric_type, 0) + value
+
+    _save_metrics(metrics)
+    _log({"action": "metric", "venture": venture, "type": metric_type, "value": value, "note": note})
+
+    return {
+        "status": "recorded",
+        "venture": venture,
+        "metric": metric_type,
+        "value": value,
+        "today_total": day[key],
+        "all_time": vtotals[metric_type],
+    }
+
+
+def get_metrics(venture: str = "", days: int = 7) -> Dict[str, Any]:
+    """Get GTM metrics — speed, revenue, launches across ventures.
+
+    Shows daily breakdown and venture totals. Used for dogfood tracking
+    and build-in-public content.
+    """
+    metrics = _load_metrics()
+
+    # Filter by date range
+    today = time.strftime("%Y-%m-%d")
+    recent_days = {}
+    for date_str, day_data in sorted(metrics["daily"].items(), reverse=True)[:days]:
+        if venture:
+            filtered = {k: v for k, v in day_data.items() if k.startswith(f"{venture}:")}
+            if filtered:
+                recent_days[date_str] = filtered
+        else:
+            recent_days[date_str] = day_data
+
+    # Venture totals
+    if venture:
+        vtotals = metrics["ventures"].get(venture, {})
+    else:
+        vtotals = metrics["ventures"]
+
+    return {
+        "status": "ok",
+        "daily": recent_days,
+        "totals": vtotals,
+        "venture_filter": venture or "all",
+        "days": days,
+    }
+
+
+# ═══════════════════════════════════════════════════════════════════════
+#  Change Management — docs freshness check before deploy
+# ═══════════════════════════════════════════════════════════════════════
+
+DOCS_CHECKLIST = [
+    {"file": "README.md", "check": "tool_count", "pattern": r"\d+ (?:MCP |governance )?tools"},
+    {"file": "README.md", "check": "version_badge", "pattern": r"GitHub%20Action-v[\d.]+"},
+    {"file": "README.md", "check": "cli_commands", "pattern": r"npx delimit-cli"},
+]
+
+
+def check_docs_freshness(
+    project_path: str = ".",
+    tool_count: int = 0,
+    version: str = "",
+) -> Dict[str, Any]:
+    """Check if documentation is up-to-date before deploying.
+
+    Verifies README, changelog, and landing page reflect current
+    tool count, version, and feature set.
+    """
+    import re
+    p = Path(project_path).resolve()
+    findings = []
+    stale = False
+
+    # Check README exists
+    readme = p / "README.md"
+    if not readme.exists():
+        findings.append({"file": "README.md", "status": "missing", "severity": "warning"})
+    else:
+        content = readme.read_text()
+
+        # Check tool count
+        if tool_count > 0:
+            counts = re.findall(r'(\d+)\s*(?:MCP |governance )?tools', content)
+            for count_str in counts:
+                count = int(count_str)
+                if abs(count - tool_count) > 10:
+                    findings.append({
+                        "file": "README.md",
+                        "status": "stale",
+                        "issue": f"Says {count} tools, actual is {tool_count}",
+                        "severity": "warning",
+                    })
+                    stale = True
+
+        # Check version badge
+        if version:
+            if version not in content:
+                findings.append({
+                    "file": "README.md",
+                    "status": "stale",
+                    "issue": f"Version badge doesn't show {version}",
+                    "severity": "info",
+                })
+
+    # Check What's New / CHANGELOG
+    changelog = p / "CHANGELOG.md"
+    if changelog.exists():
+        cl_content = changelog.read_text()
+        if version and version not in cl_content:
+            findings.append({
+                "file": "CHANGELOG.md",
+                "status": "stale",
+                "issue": f"No entry for version {version}",
+                "severity": "warning",
+            })
+            stale = True
+
+    # Check for uncommitted changes
+    try:
+        import subprocess
+        result = subprocess.run(
+            ["git", "status", "--porcelain"], capture_output=True, text=True,
+            cwd=str(p), timeout=5,
+        )
+        uncommitted = len(result.stdout.strip().split("\n")) if result.stdout.strip() else 0
+        if uncommitted > 0:
+            findings.append({
+                "file": "working tree",
+                "status": "dirty",
+                "issue": f"{uncommitted} uncommitted file(s)",
+                "severity": "info",
+            })
+    except Exception:
+        pass
+
+    return {
+        "status": "stale" if stale else "fresh",
+        "findings": findings,
+        "total_issues": len(findings),
+        "stale": stale,
+        "message": f"{len(findings)} doc issue(s) found" if findings else "Documentation is up to date",
+    }

package/lib/delimit-template.js

@@ -42,6 +42,13 @@ The founder reviews and approves via email. The AI's job is to draft, send, and
 - Deploy requested: \`delimit_security_audit\` then \`delimit_test_smoke\` then \`delimit_changelog\` then \`delimit_deploy_plan\`
 - Deploy succeeds: \`delimit_deploy_verify\` + \`delimit_evidence_collect\`
 - Verify succeeds: \`delimit_ledger_done\` (related task) + \`delimit_notify\`
+
+### Change Management (update docs with every ship)
+- After shipping a feature: update README if CLI commands or tool count changed
+- After version bump: update version badge, tool count, test count on landing page
+- After npm publish: sync gateway server.py to npm bundle, scrub PII, run security-check.sh
+- After changing pricing/tiers: update pricing page and Lemon Squeezy product
+- Before deploy: call \`delimit_swarm(action="docs_check")\` to verify docs freshness
 - Before submitting a PR to an external repo: call \`delimit_deliberate\` on the diff + PR description (Pro only — if using free tier deliberations and quota is exhausted, skip this gate but log a warning)
 
 ### Content / Outreach (all drafts, never auto-post)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "3.15.7",
+  "version": "3.15.9",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [