Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
#!/usr/bin/env python3
"""Check repository-specific CI safety rules that workflow syntax lint cannot infer."""
from __future__ import annotations
import re
import sys
from pathlib import Path
import yaml
ROOT = Path(__file__).resolve().parents[2]
# This generator rejects SHA refs. Its signed builder identity is independently
# checked by the installer verifier; no other mutable action reference is allowed.
TAG_EXCEPTIONS = {
"slsa-framework/slsa-github-generator/.github/workflows/[email protected]"
}
def audit(workflows: dict[str, dict]) -> list[str]:
findings = []
for filename, workflow in workflows.items():
if "permissions" not in workflow:
findings.append(f"{filename}: declare default token permissions")
for name, job in workflow.get("jobs", {}).items():
for step in [job, *job.get("steps", [])]:
uses = step.get("uses", "")
if uses and not uses.startswith("./") and uses not in TAG_EXCEPTIONS:
if not re.fullmatch(r"[^@]+@[0-9a-f]{40}", uses):
findings.append(f"{filename}/{name}: unpinned action {uses}")
ci = workflows["ci.yml"]["jobs"]
if set(ci) - {"gate"} != set(ci["gate"].get("needs", [])):
findings.append("ci.yml: CI gate must depend on every job")
gate_run = "\n".join(step.get("run", "") for step in ci["gate"]["steps"])
if "--pipeline" not in gate_run:
findings.append("ci.yml: CI gate must enforce expected lanes")
release = workflows["release.yml"]["jobs"]["publish"]
if "github.ref_type == 'tag'" not in release.get("if", "") or "admit" not in release["needs"]:
findings.append("release.yml: PyPI publication requires explicit tag admission")
signing = workflows["sign-installer.yml"]
if signing["permissions"] != {"contents": "read"}:
findings.append("sign-installer.yml: default permissions must be read-only")
if "provenance" not in signing["jobs"]["release"]["needs"]:
findings.append("sign-installer.yml: release upload must wait for provenance")
for filename in ("desktop-installers.yml", "sign-installer.yml"):
steps = workflows[filename]["jobs"]["release"]["steps"]
if any(step.get("uses", "").startswith("softprops/action-gh-release@") for step in steps):
findings.append(f"{filename}: producers must not change release visibility")
commands = "\n".join(step.get("run", "") for step in steps)
if "release_assets.py upload" not in commands or "--clobber" in commands:
findings.append(f"{filename}: use the verified no-replacement uploader")
provenance = signing["jobs"]["provenance"]["with"]
if provenance.get("upload-assets") is not False or "draft-release" in provenance:
findings.append("sign-installer.yml: provenance must only produce a workflow artifact")
findings += _release_bot_findings(workflows)
return findings
def _release_bot_findings(workflows: dict[str, dict]) -> list[str]:
"""Only release-cut's main-only jobs may hold the key that creates v* tags."""
findings = []
key_jobs = {"cut", "tag"}
for filename, workflow in workflows.items():
for name, job in workflow.get("jobs", {}).items():
if filename == "release-cut.yml" and name in key_jobs:
continue
if "RELEASE_APP_PRIVATE_KEY" in yaml.safe_dump(job):
findings.append(f"{filename}/{name}: only release-cut may use the release bot key")
jobs = workflows["release-cut.yml"]["jobs"]
for name in sorted(key_jobs):
if jobs.get(name, {}).get("environment") != "release-cut":
findings.append(
f"release-cut.yml: the {name} job must run in the release-cut environment"
)
# npm runs in the bundle job; it must never see a secret or a write token.
bundle = jobs.get("bundle", {})
if bundle.get("environment") or bundle.get("permissions") != {"contents": "read"}:
findings.append(
"release-cut.yml: the bundle job must have no environment and read-only contents"
)
if "secrets." in yaml.safe_dump(bundle):
findings.append("release-cut.yml: the bundle job must not read secrets")
tag_steps = jobs.get("tag", {}).get("steps", [])
tag = next((s for s in tag_steps if s.get("name") == "Tag the admitted release"), {})
if "steps.tag-token.outputs.token" not in str(tag.get("env", {}).get("GH_TOKEN", "")):
findings.append("release-cut.yml: push the release tag with the release bot token")
return findings
def main() -> int:
workflows = {
path.name: yaml.safe_load(path.read_text(encoding="utf-8"))
for path in (ROOT / ".github/workflows").glob("*.yml")
}
findings = audit(workflows)
for finding in findings:
print(f"::error::{finding}")
print(f"workflow-policy: {len(workflows)} workflows, {len(findings)} findings")
return bool(findings)
if __name__ == "__main__":
sys.exit(main())