Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
81c7b92
Register GitHub authentication proxy workstream
ccozianu Nov 16, 2026
52d574a
Add launcher-owned GitHub SSH transport proxy
ccozianu Nov 16, 2026
f1dbb33
Refurbish node registry tests for the GitHub authorization
ccozianu Nov 16, 2026
4ba1725
Keep console authorization contract aligned with GitHub access
ccozianu Nov 16, 2026
96a867f
Record proxy validation and pending review evidence
ccozianu Nov 16, 2026
890fa91
Record Hydrogen review follow-up
ccozianu Nov 16, 2026
712466a
Record accepted local review and delivery blockers
ccozianu Nov 16, 2026
f6890bb
Prepare local PEX host relaunch and Codex resume handoff
ccozianu Nov 16, 2026
d6fd93e
Propagate rootless Docker identity fix to GitHub proxy branch
ccozianu Nov 16, 2026
d679656
Record rebuilt rootless-compatible PEX and retry handoff
ccozianu Nov 16, 2026
7ec3c8c
docs: record successful host proxy relaunch preflight
ccozianu Nov 16, 2026
e45866b
test: record GitHub proxy clone in a fresh capsule
ccozianu Nov 16, 2026
ab1e30f
docs: refresh GitHub proxy PR draft with recorded acceptance
ccozianu Nov 16, 2026
7fc77f2
Merge release-0.3.1 into GitHub SSH proxy workstream
ccozianu Nov 16, 2026
4a5f88b
Record full release merge validation and rebuilt proxy acceptance
ccozianu Nov 16, 2026
9e5bf07
Record workflow definitions read after release merge
ccozianu Nov 16, 2026
73e7d8b
Record merged-build SSH proxy showcase and host relaunch acceptance
ccozianu Nov 16, 2026
d94973f
Present the SSH proxy showcase and document presentation discovery
ccozianu Nov 16, 2026
b084b32
Audit presentation authoring portability beyond the DevCapsule reposi…
ccozianu Nov 16, 2026
3f143e2
Consolidate presentation authoring handoff and refresh PR delivery
ccozianu Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CURRENT-STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ coordination branch. Detailed state belongs in each linked status file.

| Name | Started | Goal | State | Branch association | Status file |
|---|---|---|---|---|---|
| `github-auth` | 2026-11-16 | GitHub SSH authentication through a launcher-owned host proxy | paused; full release-0.3.1 merged; proxy recording and live presentation passed; inherited gate failures and PR delivery pending | `ws-github-auth/ssh-proxy` | [workstream status](engineering-docs/wip/2026-11-16-github-auth/CURRENT-STATUS.md) |
| `workflow-improvements` | 2026-08-09 | Improve the multiple-stream workflow from concrete dogfood findings during the recursive E2E cycle | active 2026-10-30; Pair Review Loop naming implemented and packaging verified for 0.3.0; mainline and release integration pending | `ws-workflow-improvements/v1` | [workstream status](engineering-docs/wip/2026-08-09-workflow-improvements/CURRENT-STATUS.md) |
| `project-management` | 2026-08-09 | Maintain project-wide priorities, sequencing, dependencies, and lifecycle coordination | paused 2026-10-11 at owner direction; consent and forced configuration before RC work; remaining diagnostics/image scope and release cut decisions retained | `ws-project-management/coordination` | [workstream status](engineering-docs/wip/2026-08-09-project-management/CURRENT-STATUS.md) |
| `maintenance` | 2026-09-18 | Own the defects no open workstream covers, on `main` and on maintained release lines, and drive maintenance releases | active; releasing 0.3.1; cut 2026-11-07 from `main` at `31e8fec7`, `main` reopened at `0.3.2.dev0` (#8); candidate 2 (`v0.3.1-rc2` on `be0140ca`, propagated to `main` via PR #22 `aabace3c`) published and verified: Eclipse libsoup (#10, closed on rc1), launcher-delivered `devcapsule_webconsole` (`D-0017`, #18/#16, closed on rc2), Codex npm abbreviated metadata (#20, closed on rc2 + `component-status` `0bc31c64`), and Codex `0.167.0` + Claude Code `2.1.321` pins (`embedded-33`, #21); rulings open: executables for the Mac, the compatibility feed's home | `release-0.3.1`, the workstream's selection from the cut to the final tag; `release-0.3.0` closed and retained; earlier slice branches merged and closed | [workstream status](engineering-docs/wip/2026-09-18-maintenance/CURRENT-STATUS.md) |
Expand Down
2 changes: 1 addition & 1 deletion WORKFLOW.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
definition: devcapsule
version: 0.3.1
version: 0.3.2.dev0
---

# Human / Agent Iteration Workflow
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
definition: devcapsule
version: 0.3.1
version: 0.3.2.dev0
---

# Human / Agent Iteration Workflow
Expand Down
37 changes: 37 additions & 0 deletions devcapsule-src/devcapsule/commands/github_ssh.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
"""Git's capsule-side SSH adapter for the authorized launcher proxy."""
from __future__ import annotations

import argparse
import os
from pathlib import Path
import subprocess
import sys

from devcapsule.commands.framework import Command
from devcapsule.compat import CliError
from devcapsule.github_transport import GitHubTransportError, parse_git_ssh
from devcapsule.github_proxy import SOCKET_ENV, relay_git


class GitHubSshCommand(Command):
name = "github-ssh"
hidden = True
help = "Git SSH transport through the authorized host GitHub proxy."
passthrough_dest = "ssh_arguments"

@classmethod
def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
try:
request = parse_git_ssh(arguments.ssh_arguments)
if request is None:
return subprocess.run(["ssh", *arguments.ssh_arguments], check=False).returncode
path = os.environ.get(SOCKET_ENV)
if not path:
raise GitHubTransportError("No authorized GitHub proxy. Enable github-ssh on the host launcher.")
return relay_git(Path(path), request, stdin=sys.stdin.buffer,

Check warning on line 31 in devcapsule-src/devcapsule/commands/github_ssh.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 24-31 are not covered by tests (advisory).

Check warning on line 31 in devcapsule-src/devcapsule/commands/github_ssh.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 24-31 are not covered by tests (advisory).
stdout=sys.stdout.buffer, stderr=sys.stderr.buffer)
except (OSError, GitHubTransportError) as error:
raise CliError(f"GitHub proxy: {error} Host keys must be trusted and encrypted keys unlocked on the host.") from error

Check warning on line 34 in devcapsule-src/devcapsule/commands/github_ssh.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 33-34 are not covered by tests (advisory).

Check warning on line 34 in devcapsule-src/devcapsule/commands/github_ssh.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 33-34 are not covered by tests (advisory).


COMMAND = GitHubSshCommand
3 changes: 2 additions & 1 deletion devcapsule-src/devcapsule/commands/project.py
Original file line number Diff line number Diff line change
Expand Up @@ -2104,7 +2104,7 @@ def subcommands(cls) -> Mapping[str, type[Command] | type[Group]]:

# The authorization nodes whose run-once answers feed the launch plan; every
# other authorization (base-image, acquisitions) is inherently persistent.
_RUN_ONCE_AUTHORIZATIONS = ("docker-daemon", "network", "development-sudo", "host-browser", "host-x11")
_RUN_ONCE_AUTHORIZATIONS = ("docker-daemon", "network", "development-sudo", "host-browser", "host-x11", "github-ssh")


class ProjectRunCommand(Command):
Expand Down Expand Up @@ -2418,6 +2418,7 @@ def prepare_display(base: ImageDetails) -> None:
extra_docker_args=["--pull=never", *saved_docker_args, *prepared.environment_tokens, *docker_options],
project_state=None,
enable_host_browser=selected_host_browser,
enable_github_ssh=host_access.github_ssh,
display_transport=display_transport,
web_console=web_console,
capsule_platform=lock_platform(lock),
Expand Down
5 changes: 5 additions & 0 deletions devcapsule-src/devcapsule/configuration/authorization.py
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,11 @@
True,
"Enable the declared development-sudo behavior inside the capsule.",
),
"github-ssh": (
True,
"Allow GitHub Git fetch and push through the outside launcher using the host SSH identity. "
"All repositories accessible to that identity are accessible; private keys stay on the host.",
),
"host-browser": (
True,
"Open HTTP(S) links from the capsule in the physical host's default browser "
Expand Down
1 change: 1 addition & 0 deletions devcapsule-src/devcapsule/configuration/console_channel.py
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@
DEFERRED_SUBVERBS = {("trust", "accept"), ("docker-args", "set")}
SECURE_AUTHORIZATIONS = {
"network": {"bridge", "none"}, "docker-daemon": {"none"},
"github-ssh": {"false", "none"},
"development-sudo": {"false", "none"}, "host-browser": {"false", "none"}, "host-x11": {"false", "none"},
}
READ_ONLY_VERBS = {"show", "check", "console"}
Expand Down
2 changes: 1 addition & 1 deletion devcapsule-src/devcapsule/configuration/listing.py
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@

LISTING_SCHEMA_VERSION = 2

HOST_ACCESS_NODES = ("network", "docker-daemon", "development-sudo", "host-browser", "host-x11")
HOST_ACCESS_NODES = ("network", "docker-daemon", "development-sudo", "host-browser", "host-x11", "github-ssh")


@dataclass(frozen=True)
Expand Down
2 changes: 1 addition & 1 deletion devcapsule-src/devcapsule/configuration/resolution.py
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@ def base_reference(self) -> str | None:
@property
def host_access(self) -> HostAccess:
authorizations = self._document.get("authorization", {})
host_names = {"docker-daemon", "network", "development-sudo", "host-browser", "host-x11"}
host_names = {"docker-daemon", "network", "development-sudo", "host-browser", "host-x11", "github-ssh"}
return HostAccess().overlay(self._document.get("host", {})).overlay({
name: value for name, value in authorizations.items() if name in host_names
})
4 changes: 3 additions & 1 deletion devcapsule-src/devcapsule/configuration/review.py
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ class HostAccess:
docker_daemon: str = "none"
network: str = "bridge"
development_sudo: bool = False
github_ssh: bool = False
host_browser: bool = False
host_x11: bool | None = None

Expand All @@ -35,6 +36,7 @@ def overlay(self, answers: Mapping[str, Any]) -> HostAccess:
"docker-daemon": ("docker_daemon", ("none", "host-socket")),
"network": ("network", ("bridge", "host")),
"development-sudo": ("development_sudo", (False, True)),
"github-ssh": ("github_ssh", (False, True)),
"host-browser": ("host_browser", (False, True)),
"host-x11": ("host_x11", (False, True)),
}
Expand Down Expand Up @@ -127,7 +129,7 @@ def resolved_authorizations(self) -> dict[str, AuthorizationScalar]:
def effective_host(self, overrides: Mapping[str, Any] | None = None) -> HostAccess:
answers = {
name: value for name, value in self.resolved_authorizations().items()
if name in {"docker-daemon", "network", "development-sudo", "host-browser", "host-x11"}
if name in {"docker-daemon", "network", "development-sudo", "host-browser", "host-x11", "github-ssh"}
}
return self.legacy_host.overlay(answers).overlay(overrides or {})

Expand Down
Loading
Loading