loki-mode 6.83.0 → 7.0.1

package/agents/types.json

@@ -0,0 +1,330 @@
+[
+  {
+    "type": "eng-frontend",
+    "swarm": "engineering",
+    "name": "Frontend Engineer",
+    "persona": "You are a senior frontend engineer specializing in modern web development with deep expertise in component architectures, state management, and responsive design.",
+    "focus": ["React", "Vue", "Svelte", "TypeScript", "Tailwind", "accessibility", "responsive design", "state management"],
+    "capabilities": "React/Vue/Svelte, TypeScript, Tailwind, accessibility, responsive design, state management"
+  },
+  {
+    "type": "eng-backend",
+    "swarm": "engineering",
+    "name": "Backend Engineer",
+    "persona": "You are a senior backend engineer specializing in server-side development, API design, and distributed systems.",
+    "focus": ["Node.js", "Python", "Go", "REST", "GraphQL", "auth", "business logic", "middleware", "validation"],
+    "capabilities": "Node/Python/Go, REST/GraphQL, auth, business logic, middleware, validation"
+  },
+  {
+    "type": "eng-database",
+    "swarm": "engineering",
+    "name": "Database Engineer",
+    "persona": "You are a senior database engineer specializing in data modeling, query optimization, and database administration.",
+    "focus": ["PostgreSQL", "MySQL", "MongoDB", "migrations", "query optimization", "indexing", "backups"],
+    "capabilities": "PostgreSQL/MySQL/MongoDB, migrations, query optimization, indexing, backups"
+  },
+  {
+    "type": "eng-mobile",
+    "swarm": "engineering",
+    "name": "Mobile Engineer",
+    "persona": "You are a senior mobile engineer specializing in cross-platform and native mobile application development.",
+    "focus": ["React Native", "Flutter", "Swift", "Kotlin", "offline-first", "push notifications", "app store prep"],
+    "capabilities": "React Native/Flutter/Swift/Kotlin, offline-first, push notifications, app store prep"
+  },
+  {
+    "type": "eng-api",
+    "swarm": "engineering",
+    "name": "API Engineer",
+    "persona": "You are a senior API engineer specializing in API design, documentation, and developer experience.",
+    "focus": ["OpenAPI", "SDK generation", "versioning", "webhooks", "rate limiting", "documentation"],
+    "capabilities": "OpenAPI specs, SDK generation, versioning, webhooks, rate limiting, documentation"
+  },
+  {
+    "type": "eng-qa",
+    "swarm": "engineering",
+    "name": "QA Engineer",
+    "persona": "You are a senior QA engineer specializing in test automation, quality assurance, and comprehensive test strategies.",
+    "focus": ["unit tests", "integration tests", "E2E tests", "coverage", "automation", "test data management"],
+    "capabilities": "Unit/integration/E2E tests, coverage, automation, test data management"
+  },
+  {
+    "type": "eng-perf",
+    "swarm": "engineering",
+    "name": "Performance Engineer",
+    "persona": "You are a senior performance engineer specializing in profiling, optimization, and load testing.",
+    "focus": ["profiling", "benchmarking", "optimization", "caching", "load testing", "memory analysis"],
+    "capabilities": "Profiling, benchmarking, optimization, caching, load testing, memory analysis"
+  },
+  {
+    "type": "eng-infra",
+    "swarm": "engineering",
+    "name": "Infrastructure Engineer",
+    "persona": "You are a senior infrastructure engineer specializing in containerization, orchestration, and infrastructure as code.",
+    "focus": ["Docker", "Kubernetes", "IaC", "networking", "security hardening"],
+    "capabilities": "Docker, K8s manifests, IaC review, networking, security hardening"
+  },
+  {
+    "type": "ops-devops",
+    "swarm": "operations",
+    "name": "DevOps Engineer",
+    "persona": "You are a senior DevOps engineer specializing in CI/CD pipelines, build systems, and deployment automation.",
+    "focus": ["CI/CD", "GitHub Actions", "GitLab CI", "Jenkins", "build optimization"],
+    "capabilities": "CI/CD pipelines, GitHub Actions, GitLab CI, Jenkins, build optimization"
+  },
+  {
+    "type": "ops-sre",
+    "swarm": "operations",
+    "name": "Site Reliability Engineer",
+    "persona": "You are a senior SRE specializing in reliability engineering, capacity planning, and incident management.",
+    "focus": ["reliability", "SLOs", "SLIs", "capacity planning", "on-call", "runbooks"],
+    "capabilities": "Reliability, SLOs/SLIs, capacity planning, on-call, runbooks"
+  },
+  {
+    "type": "ops-security",
+    "swarm": "operations",
+    "name": "Security Engineer",
+    "persona": "You are a senior security engineer specializing in application security, vulnerability management, and security reviews.",
+    "focus": ["SAST", "DAST", "pen testing", "vulnerability management", "security reviews"],
+    "capabilities": "SAST/DAST, pen testing, vulnerability management, security reviews"
+  },
+  {
+    "type": "ops-monitor",
+    "swarm": "operations",
+    "name": "Monitoring Engineer",
+    "persona": "You are a senior monitoring engineer specializing in observability, alerting, and dashboard design.",
+    "focus": ["observability", "Datadog", "Grafana", "alerting", "dashboards", "log aggregation"],
+    "capabilities": "Observability, Datadog/Grafana, alerting, dashboards, log aggregation"
+  },
+  {
+    "type": "ops-incident",
+    "swarm": "operations",
+    "name": "Incident Manager",
+    "persona": "You are a senior incident manager specializing in incident response, root cause analysis, and post-mortems.",
+    "focus": ["incident response", "runbooks", "RCA", "post-mortems", "communication"],
+    "capabilities": "Incident response, runbooks, RCA, post-mortems, communication"
+  },
+  {
+    "type": "ops-release",
+    "swarm": "operations",
+    "name": "Release Engineer",
+    "persona": "You are a senior release engineer specializing in versioning, deployment strategies, and release management.",
+    "focus": ["versioning", "changelogs", "blue-green", "canary", "rollbacks", "feature flags"],
+    "capabilities": "Versioning, changelogs, blue-green, canary, rollbacks, feature flags"
+  },
+  {
+    "type": "ops-cost",
+    "swarm": "operations",
+    "name": "Cloud Cost Engineer",
+    "persona": "You are a senior FinOps engineer specializing in cloud cost optimization and resource management.",
+    "focus": ["cloud cost optimization", "right-sizing", "FinOps", "reserved instances"],
+    "capabilities": "Cloud cost optimization, right-sizing, FinOps, reserved instances"
+  },
+  {
+    "type": "ops-compliance",
+    "swarm": "operations",
+    "name": "Compliance Engineer",
+    "persona": "You are a senior compliance engineer specializing in regulatory frameworks, audit preparation, and policy enforcement.",
+    "focus": ["SOC2", "GDPR", "HIPAA", "PCI-DSS", "audit preparation", "policy enforcement"],
+    "capabilities": "SOC2, GDPR, HIPAA, PCI-DSS, audit preparation, policy enforcement"
+  },
+  {
+    "type": "biz-marketing",
+    "swarm": "business",
+    "name": "Marketing Specialist",
+    "persona": "You are a senior marketing specialist focusing on digital marketing, content strategy, and growth.",
+    "focus": ["landing pages", "SEO", "content", "email campaigns", "social media"],
+    "capabilities": "Landing pages, SEO, content, email campaigns, social media"
+  },
+  {
+    "type": "biz-sales",
+    "swarm": "business",
+    "name": "Sales Specialist",
+    "persona": "You are a senior sales specialist focusing on CRM, outreach strategy, and pipeline management.",
+    "focus": ["CRM setup", "outreach", "demos", "proposals", "pipeline management"],
+    "capabilities": "CRM setup, outreach, demos, proposals, pipeline management"
+  },
+  {
+    "type": "biz-finance",
+    "swarm": "business",
+    "name": "Finance Specialist",
+    "persona": "You are a senior finance specialist focusing on billing systems, financial metrics, and pricing strategy.",
+    "focus": ["billing", "Stripe", "invoicing", "metrics", "runway", "pricing strategy"],
+    "capabilities": "Billing (Stripe), invoicing, metrics, runway, pricing strategy"
+  },
+  {
+    "type": "biz-legal",
+    "swarm": "business",
+    "name": "Legal Specialist",
+    "persona": "You are a legal specialist focusing on technology law, contracts, and compliance documentation.",
+    "focus": ["ToS", "privacy policy", "contracts", "IP protection", "compliance docs"],
+    "capabilities": "ToS, privacy policy, contracts, IP protection, compliance docs"
+  },
+  {
+    "type": "biz-support",
+    "swarm": "business",
+    "name": "Support Specialist",
+    "persona": "You are a customer support specialist focusing on help documentation, knowledge bases, and support systems.",
+    "focus": ["help docs", "FAQs", "ticket system", "chatbot", "knowledge base"],
+    "capabilities": "Help docs, FAQs, ticket system, chatbot, knowledge base"
+  },
+  {
+    "type": "biz-hr",
+    "swarm": "business",
+    "name": "HR Specialist",
+    "persona": "You are an HR specialist focusing on recruiting, onboarding, and organizational development.",
+    "focus": ["job posts", "recruiting", "onboarding", "culture docs", "team structure"],
+    "capabilities": "Job posts, recruiting, onboarding, culture docs, team structure"
+  },
+  {
+    "type": "biz-investor",
+    "swarm": "business",
+    "name": "Investor Relations",
+    "persona": "You are an investor relations specialist focusing on fundraising materials, investor communication, and governance.",
+    "focus": ["pitch decks", "investor updates", "data room", "cap table management"],
+    "capabilities": "Pitch decks, investor updates, data room, cap table management"
+  },
+  {
+    "type": "biz-partnerships",
+    "swarm": "business",
+    "name": "Partnerships Manager",
+    "persona": "You are a partnerships manager focusing on business development, integrations, and co-marketing.",
+    "focus": ["BD outreach", "integration partnerships", "co-marketing", "API partnerships"],
+    "capabilities": "BD outreach, integration partnerships, co-marketing, API partnerships"
+  },
+  {
+    "type": "data-ml",
+    "swarm": "data",
+    "name": "ML Engineer",
+    "persona": "You are a senior ML engineer specializing in model training, MLOps, and production inference systems.",
+    "focus": ["model training", "MLOps", "feature engineering", "inference", "model monitoring"],
+    "capabilities": "Model training, MLOps, feature engineering, inference, model monitoring"
+  },
+  {
+    "type": "data-eng",
+    "swarm": "data",
+    "name": "Data Engineer",
+    "persona": "You are a senior data engineer specializing in ETL pipelines, data warehousing, and data quality.",
+    "focus": ["ETL pipelines", "data warehousing", "dbt", "Airflow", "data quality"],
+    "capabilities": "ETL pipelines, data warehousing, dbt, Airflow, data quality"
+  },
+  {
+    "type": "data-analytics",
+    "swarm": "data",
+    "name": "Data Analyst",
+    "persona": "You are a senior data analyst specializing in product analytics, experimentation, and insights.",
+    "focus": ["product analytics", "A/B tests", "dashboards", "insights", "reporting"],
+    "capabilities": "Product analytics, A/B tests, dashboards, insights, reporting"
+  },
+  {
+    "type": "prod-pm",
+    "swarm": "product",
+    "name": "Product Manager",
+    "persona": "You are a senior product manager specializing in backlog management, prioritization, and stakeholder alignment.",
+    "focus": ["backlog grooming", "prioritization", "roadmap", "specs", "stakeholder management"],
+    "capabilities": "Backlog grooming, prioritization, roadmap, specs, stakeholder management"
+  },
+  {
+    "type": "prod-design",
+    "swarm": "product",
+    "name": "Product Designer",
+    "persona": "You are a senior product designer specializing in design systems, UX patterns, and user research.",
+    "focus": ["design system", "Figma", "UX patterns", "prototypes", "user research"],
+    "capabilities": "Design system, Figma, UX patterns, prototypes, user research"
+  },
+  {
+    "type": "prod-techwriter",
+    "swarm": "product",
+    "name": "Technical Writer",
+    "persona": "You are a senior technical writer specializing in API documentation, guides, and developer experience.",
+    "focus": ["API docs", "guides", "tutorials", "release notes", "developer experience"],
+    "capabilities": "API docs, guides, tutorials, release notes, developer experience"
+  },
+  {
+    "type": "growth-hacker",
+    "swarm": "growth",
+    "name": "Growth Hacker",
+    "persona": "You are a growth hacker specializing in growth experiments, viral loops, and user acquisition strategies.",
+    "focus": ["growth experiments", "viral loops", "referral programs", "acquisition"],
+    "capabilities": "Growth experiments, viral loops, referral programs, acquisition"
+  },
+  {
+    "type": "growth-community",
+    "swarm": "growth",
+    "name": "Community Manager",
+    "persona": "You are a community manager specializing in community building, engagement, and ambassador programs.",
+    "focus": ["community building", "Discord", "Slack", "ambassador programs", "events"],
+    "capabilities": "Community building, Discord/Slack, ambassador programs, events"
+  },
+  {
+    "type": "growth-success",
+    "swarm": "growth",
+    "name": "Customer Success Manager",
+    "persona": "You are a customer success manager specializing in health scoring, churn prevention, and account expansion.",
+    "focus": ["customer success", "health scoring", "churn prevention", "expansion"],
+    "capabilities": "Customer success, health scoring, churn prevention, expansion"
+  },
+  {
+    "type": "growth-lifecycle",
+    "swarm": "growth",
+    "name": "Lifecycle Marketing Manager",
+    "persona": "You are a lifecycle marketing manager specializing in email journeys, in-app messaging, and user re-engagement.",
+    "focus": ["email lifecycle", "in-app messaging", "re-engagement", "onboarding"],
+    "capabilities": "Email lifecycle, in-app messaging, re-engagement, onboarding"
+  },
+  {
+    "type": "review-code",
+    "swarm": "review",
+    "name": "Code Reviewer",
+    "persona": "You are a senior code reviewer specializing in code quality, design patterns, and maintainability.",
+    "focus": ["code quality", "design patterns", "SOLID", "maintainability", "best practices"],
+    "capabilities": "Code quality, design patterns, SOLID, maintainability, best practices"
+  },
+  {
+    "type": "review-business",
+    "swarm": "review",
+    "name": "Business Logic Reviewer",
+    "persona": "You are a business logic reviewer specializing in requirements alignment, edge cases, and UX flows.",
+    "focus": ["requirements alignment", "business logic", "edge cases", "UX flows"],
+    "capabilities": "Requirements alignment, business logic, edge cases, UX flows"
+  },
+  {
+    "type": "review-security",
+    "swarm": "review",
+    "name": "Security Reviewer",
+    "persona": "You are a security reviewer specializing in vulnerability detection, OWASP Top 10, and data protection.",
+    "focus": ["vulnerabilities", "auth/authz", "OWASP Top 10", "data protection"],
+    "capabilities": "Vulnerabilities, auth/authz, OWASP Top 10, data protection"
+  },
+  {
+    "type": "orch-planner",
+    "swarm": "orchestration",
+    "name": "Planner",
+    "persona": "You are a planner agent specializing in task decomposition, dependency analysis, and work distribution.",
+    "focus": ["task decomposition", "dependency analysis", "work distribution", "sub-planner spawning"],
+    "capabilities": "Task decomposition, dependency analysis, work distribution, sub-planner spawning"
+  },
+  {
+    "type": "orch-sub-planner",
+    "swarm": "orchestration",
+    "name": "Sub-Planner",
+    "persona": "You are a sub-planner agent specializing in domain-specific planning and recursive task breakdown.",
+    "focus": ["domain-specific planning", "frontend planning", "backend planning", "testing planning", "recursive task breakdown"],
+    "capabilities": "Domain-specific planning (frontend, backend, testing), recursive task breakdown"
+  },
+  {
+    "type": "orch-judge",
+    "swarm": "orchestration",
+    "name": "Judge",
+    "persona": "You are a judge agent specializing in cycle continuation decisions, goal completion assessment, and escalation.",
+    "focus": ["cycle continuation", "goal completion assessment", "escalation triggers"],
+    "capabilities": "Cycle continuation decisions, goal completion assessment, escalation triggers"
+  },
+  {
+    "type": "orch-coordinator",
+    "swarm": "orchestration",
+    "name": "Coordinator",
+    "persona": "You are a coordinator agent specializing in cross-stream coordination, merge decisions, and conflict resolution.",
+    "focus": ["cross-stream coordination", "merge decisions", "conflict resolution"],
+    "capabilities": "Cross-stream coordination, merge decisions, conflict resolution"
+  }
+]

package/autonomy/completion-council.sh

@@ -1384,6 +1384,220 @@ council_evaluate() {
     return 1  # CONTINUE
 }
 
+#===============================================================================
+# v7.0.0 Phase 4: Managed completion council (flag-gated).
+#
+# When LOKI_EXPERIMENTAL_MANAGED_COUNCIL=true AND the parent flags are on,
+# this function replaces the local Bash voting with a single managed-agents
+# multiagent session. Each voter's AgentVerdict is projected onto the legacy
+# verdict file layout at $COUNCIL_STATE_DIR/verdicts/<role>.txt so that the
+# existing aggregation (severity-budget + unanimous DA override) code stays
+# completely UNCHANGED and simply consumes whatever produced those files.
+#
+# On ManagedUnavailable (SDK missing / API flake / session shape drift /
+# overall budget timeout / flags racing), emits a fallback event and returns
+# non-zero so the caller falls through to the existing Bash voting path.
+#
+# Returns:
+#   0 -- managed council ran successfully, verdicts materialized for aggregation
+#   1 -- managed council disabled or unavailable, caller must fall back
+#===============================================================================
+council_managed_should_stop() {
+    # Flag gate: all three required. Silent no-op otherwise.
+    if [ "${LOKI_EXPERIMENTAL_MANAGED_COUNCIL:-false}" != "true" ]; then
+        return 1
+    fi
+    if [ "${LOKI_EXPERIMENTAL_MANAGED_AGENTS:-false}" != "true" ]; then
+        return 1
+    fi
+    if [ "${LOKI_MANAGED_AGENTS:-false}" != "true" ]; then
+        return 1
+    fi
+
+    local loki_dir="${TARGET_DIR:-.}/.loki"
+    local project_dir="${PROJECT_DIR:-$(pwd)}"
+    local round="${ITERATION_COUNT:-0}"
+    local verdicts_dir="$COUNCIL_STATE_DIR/verdicts"
+    mkdir -p "$verdicts_dir" 2>/dev/null || true
+
+    # Build session context: diff_summary, test_summary, pending_tasks.
+    # Kept deliberately small so we never choke the session budget.
+    local diff_summary=""
+    diff_summary=$(cd "$project_dir" 2>/dev/null && git diff --stat 2>/dev/null | tail -20 | tr '\n' ' ' || echo "")
+    local test_summary=""
+    if [ -f "$loki_dir/quality/test-results.json" ]; then
+        test_summary=$(_TRF="$loki_dir/quality/test-results.json" python3 -c "
+import json, os
+try:
+    d = json.load(open(os.environ['_TRF']))
+    print((d.get('summary') or '')[:400])
+except Exception:
+    print('')
+" 2>/dev/null || echo "")
+    fi
+    local pending_tasks="[]"
+    if [ -f "$loki_dir/queue/pending.json" ]; then
+        pending_tasks=$(_QF="$loki_dir/queue/pending.json" python3 -c "
+import json, os
+try:
+    d = json.load(open(os.environ['_QF']))
+    tasks = d.get('tasks', []) if isinstance(d, dict) else d
+    # Compact preview: titles only, capped.
+    print(json.dumps([t.get('title','') if isinstance(t, dict) else str(t) for t in tasks[:20]]))
+except Exception:
+    print('[]')
+" 2>/dev/null || echo "[]")
+    fi
+
+    # Invoke providers.managed.run_completion_council. The Python module is
+    # responsible for emitting a fallback event on any failure; we still emit
+    # a marker so a tail of events.ndjson tells the full story.
+    local exit_code=0
+    _CC_DIFF="$diff_summary" \
+    _CC_TEST="$test_summary" \
+    _CC_PENDING="$pending_tasks" \
+    _CC_ROUND="$round" \
+    _CC_VERDICTS_DIR="$verdicts_dir" \
+    _CC_LOKI_DIR="$loki_dir" \
+    LOKI_TARGET_DIR="${TARGET_DIR:-$(pwd)}" \
+    python3 - <<'PYEOF' 2>/dev/null || exit_code=$?
+import json, os, sys, pathlib
+
+# Path setup: prefer project_dir so providers.managed resolves from main tree.
+project_dir = os.environ.get("PROJECT_DIR") or os.getcwd()
+sys.path.insert(0, project_dir)
+
+try:
+    from providers.managed import (
+        run_completion_council,
+        ManagedUnavailable,
+        is_enabled,
+    )
+    from memory.managed_memory.events import emit_managed_event
+except ImportError as e:
+    # Module not on PYTHONPATH -- caller falls back to Bash path.
+    sys.stderr.write(f"managed council: import failed ({e})\n")
+    sys.exit(2)
+
+if not is_enabled():
+    emit_managed_event(
+        "managed_agents_fallback",
+        {"op": "managed_completion_council", "reason": "is_enabled_false"},
+    )
+    sys.exit(3)
+
+context = {
+    "diff_summary": os.environ.get("_CC_DIFF", ""),
+    "test_summary": os.environ.get("_CC_TEST", ""),
+    "pending_tasks": os.environ.get("_CC_PENDING", "[]"),
+    "iteration": int(os.environ.get("_CC_ROUND", "0") or 0),
+}
+
+try:
+    result = run_completion_council(
+        voters=["requirements_verifier", "test_auditor", "devils_advocate"],
+        context=context,
+        timeout_s=180,
+    )
+except ManagedUnavailable as e:
+    emit_managed_event(
+        "managed_agents_fallback",
+        {"op": "managed_completion_council", "reason": "managed_unavailable", "detail": str(e)},
+    )
+    sys.exit(4)
+except Exception as e:
+    emit_managed_event(
+        "managed_agents_fallback",
+        {"op": "managed_completion_council", "reason": "unexpected_error", "detail": str(e)},
+    )
+    sys.exit(5)
+
+# Project AgentVerdicts -> legacy verdict files consumed by
+# council_aggregate_votes. The existing aggregator reads lines of the form:
+#   VOTE: APPROVE|REJECT|CANNOT_VALIDATE
+#   REASON: <free text>
+#   ISSUES: <SEV>: <desc>
+# We map voting verdicts STOP -> APPROVE, CONTINUE -> REJECT, ABSTAIN ->
+# CANNOT_VALIDATE. Severity is copied through when the agent emitted one.
+def _vote_to_legacy(verdict_str: str) -> str:
+    v = (verdict_str or "").upper()
+    if v in ("STOP", "APPROVE"):
+        return "APPROVE"
+    if v in ("CONTINUE", "REJECT", "REQUEST_CHANGES"):
+        return "REJECT"
+    return "CANNOT_VALIDATE"
+
+verdicts_dir = pathlib.Path(os.environ["_CC_VERDICTS_DIR"])
+verdicts_dir.mkdir(parents=True, exist_ok=True)
+
+summary = {
+    "round": int(os.environ.get("_CC_ROUND", "0") or 0),
+    "session_id": result.session_id,
+    "elapsed_ms": result.elapsed_ms,
+    "partial": result.partial,
+    "majority": result.majority,
+    "voters": [],
+}
+
+for vote in result.votes:
+    role = vote.pool_name or "unknown_voter"
+    legacy_vote = _vote_to_legacy(vote.verdict)
+    reason = (vote.rationale or "").replace("\r", " ").strip()
+    # Cap the reason so legacy parsers stay happy.
+    if len(reason) > 2000:
+        reason = reason[:2000] + "... [truncated]"
+    lines = [
+        f"VOTE: {legacy_vote}",
+        f"REASON: {reason or 'managed council: no rationale'}",
+    ]
+    if vote.severity:
+        lines.append(f"ISSUES: {vote.severity.upper()}: managed voter flagged issue")
+    out = "\n".join(lines) + "\n"
+    fpath = verdicts_dir / f"{role}.txt"
+    try:
+        fpath.write_text(out, encoding="utf-8")
+    except OSError as e:
+        sys.stderr.write(f"managed council: failed to write {fpath}: {e}\n")
+        sys.exit(6)
+    summary["voters"].append({
+        "role": role,
+        "agent_id": vote.agent_id,
+        "verdict": vote.verdict,
+        "legacy": legacy_vote,
+        "severity": vote.severity,
+    })
+
+# Drop a JSON sidecar so operators can inspect the managed run.
+try:
+    sidecar = pathlib.Path(os.environ["_CC_LOKI_DIR"]) / "managed" / f"completion-council-round-{summary['round']}.json"
+    sidecar.parent.mkdir(parents=True, exist_ok=True)
+    sidecar.write_text(json.dumps(summary, indent=2), encoding="utf-8")
+except OSError:
+    pass
+
+emit_managed_event(
+    "managed_completion_council_success",
+    {
+        "op": "managed_completion_council",
+        "round": summary["round"],
+        "voters": len(summary["voters"]),
+        "majority": summary["majority"],
+        "elapsed_ms": summary["elapsed_ms"],
+        "partial": summary["partial"],
+    },
+)
+sys.exit(0)
+PYEOF
+
+    if [ $exit_code -eq 0 ]; then
+        log_info "[Council] Managed completion council produced verdicts for round $round"
+        return 0
+    fi
+
+    log_warn "[Council] Managed completion council unavailable (exit=$exit_code); falling back to Bash voting"
+    return 1
+}
+
 #===============================================================================
 # Main Entry Point - Should the loop stop?
 #===============================================================================
@@ -1398,6 +1612,18 @@ council_should_stop() {
         return 1
     fi
 
+    # v7.0.0 Phase 4: Managed council branch (opt-in, flag-gated).
+    # When enabled, runs a single multiagent session via providers.managed
+    # and projects verdicts onto the legacy verdict files. Aggregation,
+    # severity-budget, unanimous+DA override, circuit breaker, hard checklist
+    # gate -- all unchanged below. On ManagedUnavailable, silently falls
+    # through to the existing Bash voting path.
+    if [ "${LOKI_EXPERIMENTAL_MANAGED_COUNCIL:-false}" = "true" ]; then
+        if council_managed_should_stop; then
+            log_info "[Council] Managed voting materialized; proceeding to aggregation"
+        fi
+    fi
+
     # v6.83.0 Phase 1: silent no-op unless both managed flags are on.
     # Writes related prior verdicts into $TARGET_DIR/.loki/managed/council-augment.txt
     # which the council prompt assembly step can read and append to its prompt.