Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
52 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
388f62a
Review corrections for GitHub SSH proxy
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
03ec510
Register presentations for agent-driven E2E recordings and presentations
ccozianu Nov 16, 2026
3a6811a
Receive the presentation use-case handoff from project management
ccozianu Nov 16, 2026
f40c574
Acknowledge the presentation use case and preserve its handoff
ccozianu Nov 16, 2026
587846d
Package E2E presentation authoring for adopter agents
ccozianu Nov 16, 2026
78f512c
Record the release workflow definition read at publication
ccozianu Nov 16, 2026
9bbedff
Start Gemini Hydrogen High Pair Review for presentation PR 43
ccozianu Nov 16, 2026
e40d16a
Presentations: harden kit validation, token handling, and test coverage
ccozianu Nov 16, 2026
d4510fe
Assess presentation review 46 and request focused test corrections
ccozianu Nov 16, 2026
e331693
Presentations: align recorder unit tests to rule 2 and clarify guide …
ccozianu Nov 16, 2026
d456431
Merge PR #46: Gemini Hydrogen High review of presentation authoring
ccozianu Nov 16, 2026
747d901
Record completed presentation Pair Review and final validation
ccozianu Nov 16, 2026
1879bf4
Record SSH proxy workstream resumption
ccozianu Nov 16, 2026
38928b9
Target GitHub SSH proxy delivery at release 0.3.1
ccozianu Nov 16, 2026
e037d06
Merge branch 'ws-github-auth/ssh-proxy' into ws-github-auth/ssh-proxy…
ccozianu Nov 16, 2026
336fc3e
Match SSH proxy version to its release target
ccozianu Nov 16, 2026
ea03cfd
Merge branch 'ws-github-auth/ssh-proxy' into ws-github-auth/ssh-proxy…
ccozianu Nov 16, 2026
23c942f
Brief SSH proxy reviewer on release target and final corrections
ccozianu Nov 16, 2026
455d3ac
Bound proxy readiness handshake and parameterize bridge unit test
ccozianu Nov 16, 2026
9638cb1
Merge PR #44: GitHub SSH proxy Pair Review corrections
ccozianu Nov 16, 2026
3ed31a8
Complete SSH proxy Pair Review and record release 0.3.1 delivery
ccozianu Nov 16, 2026
7d76e07
Record SSH proxy release handoff to maintenance
ccozianu Nov 16, 2026
a464088
Merge pull request #47 from mycodespace-ai/ws-github-auth/ssh-proxy
ccozianu Nov 16, 2026
566867b
Merge branch 'release-0.3.1' into ws-presentations/0.3.1-authoring
ccozianu Nov 16, 2026
579d0e6
Receive maintenance delivery and release-policy handoffs
ccozianu Nov 17, 2026
bf4fa1f
Record rc3 preflight, release tally and accepted maintenance intake
ccozianu Nov 17, 2026
87c35ba
Align release integration fixtures with rootless Docker probing
ccozianu Nov 17, 2026
2dc5e2d
Record successful rc3 integration preflight correction
ccozianu Nov 17, 2026
c8b56a0
Merge pull request #43 from mycodespace-ai/ws-presentations/0.3.1-aut…
ccozianu Nov 17, 2026
918f9fc
Merge pull request #48 from mycodespace-ai/ws-maintenance/0.3.1-rc3-p…
ccozianu Nov 17, 2026
7152bdd
Preserve main development version and documents in release propagation
ccozianu Nov 17, 2026
98d6619
Record main PR handoff and current workflow version
ccozianu Nov 17, 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
4 changes: 3 additions & 1 deletion CURRENT-STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,11 @@ coordination branch. Detailed state belongs in each linked status file.

| Name | Started | Goal | State | Branch association | Status file |
|---|---|---|---|---|---|
| `presentations` | 2026-11-16 | Deliver agent-driven E2E recording and presentation from Markdown or inline English in adopter DevCapsules | paused; PR #43 reviewed; awaits owner merge to release 0.3.1 | `ws-presentations/0.3.1-authoring` | [workstream status](engineering-docs/wip/2026-11-16-presentations/CURRENT-STATUS.md) |
| `github-auth` | 2026-11-16 | GitHub SSH authentication through a launcher-owned host proxy | paused; Pair Review #44 merged; PR #47 targets release-0.3.1; two inherited gate failures remain | `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) |
| `maintenance` | 2026-09-18 | Own the defects no open workstream covers, on `main` and on maintained release lines, and drive maintenance releases | integrating; release `918f9fc7` includes SSH proxy #47, presentations #43 and preflight correction #48; main preservation approved, rc3 waits for main integration; four unresolved release bugs, one blocking | `release-0.3.1`, release driver; `4PR-6-release-0.3.1`, main PR copy with owner-approved preservation commit retaining 0.3.2.dev0; `release-0.3.0` closed and retained | [workstream status](engineering-docs/wip/2026-09-18-maintenance/CURRENT-STATUS.md) |
| `component-upgrades` | 2026-09-21 | Deliver component distribution channels, developer-owned version sets and proven upgrade rollback; Codex first | paused 2026-10-02; consent design ruled (D-0011 to D-0013), 0.2.16 consent slice next; R-UPGRADE-002 follow-up retained | `ws-component-upgrades/v1` | [workstream status](engineering-docs/wip/2026-09-21-component-upgrades/CURRENT-STATUS.md) |
| `sample-projects` | 2026-08-14 | Provide realistic sample projects as submodules that demonstrate ordinary adopter development inside DevCapsule | samples left the repository as submodules 2026-11-05; their future form is the owner's later decision | `ws-sample-projects/ai-learning` | [workstream status](engineering-docs/wip/2026-08-14-sample-projects/CURRENT-STATUS.md) |
| `contained-display` | 2026-08-19 | Own the capsule supervisor core (container entry process, supervised children, explicit session end, headless mode) and the capsule's own display environment, closing the host-session credential exposure — supervisor first, display as its first consumer | active; **the contained display shipped in v0.2.12 on 2026-09-14** (recipe-9 base, contained desktop by default, X11 passthrough behind `host-x11`); the X11 credential bug is resolved; remaining threads are records and follow-ups (reconnect, WSL2 opener, sample locks) | `ws-contained-display/display-transport` | [workstream status](engineering-docs/wip/2026-08-19-contained-display/CURRENT-STATUS.md) |
Expand Down
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,11 @@ default. You decide what additional access to grant.

See a sample of a full graphical IDE running inside DevCapsule's isolated Docker container. More scenario illustrations coming soon.

To record an E2E scenario in your own project, ask your agent to run it with recording
and presentation. `devcapsule presentations guide` provides the installed instructions;
`devcapsule presentations export <new-directory>` supplies the Python/Playwright helpers.
See the [agent recording guide](devcapsule-src/devcapsule/presentation_tools/README.md).

<!-- website:benefits -->
## Why switch to DevCapsule?

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
45 changes: 45 additions & 0 deletions devcapsule-src/devcapsule/commands/github_ssh.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
"""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)
except GitHubTransportError as error:
raise CliError(

Check warning on line 27 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-27 are not covered by tests (advisory).
f"GitHub proxy: {error} Host keys must be trusted and encrypted keys unlocked on the host."
) from error
if request is None:
try:
return subprocess.run(["ssh", *arguments.ssh_arguments], check=False).returncode
except OSError as error:
raise CliError(f"Capsule SSH: {error}") from error
try:
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 39 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 30-39 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 42 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 41-42 are not covered by tests (advisory).


COMMAND = GitHubSshCommand
89 changes: 89 additions & 0 deletions devcapsule-src/devcapsule/commands/presentations.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
"""Entry points for the packaged agent recording instructions and Python helpers."""
import argparse
from importlib.resources import files
import os
from pathlib import Path
from typing import Mapping

from devcapsule.commands.framework import Command, Group
from devcapsule.compat import CliError
from devcapsule.presentation_authoring import export_tools, presentation_link

__all__ = ["COMMAND"]

PACKAGE = "devcapsule.presentation_tools"
ASSETS = ("__init__.py", "producer.py", "recording.py", "README.md", "example.py")


class GuideCommand(Command):
name = "guide"
help = "Read the agent instructions for English-specified E2E recordings."

@classmethod
def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
print(files(PACKAGE).joinpath("README.md").read_text(encoding="utf-8"))
return 0

Check warning on line 25 in devcapsule-src/devcapsule/commands/presentations.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

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


class ExportCommand(Command):
name = "export"
help = "Export the instructions and standalone Python helpers to a new directory."

@classmethod
def configure(cls, parser: argparse.ArgumentParser) -> None:
parser.add_argument("directory", type=Path, help="New directory; existing directories are preserved.")

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

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

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

@classmethod
def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
assets = {name: files(PACKAGE).joinpath(name).read_bytes() for name in ASSETS}
try:
package = export_tools(arguments.directory, assets)
except (OSError, ValueError) as error:
raise CliError(f"cannot export presentation tools: {error}") from error
print(f"Presentation tools: {package}\nAgent instructions: {package / 'README.md'}")
return 0

Check warning on line 44 in devcapsule-src/devcapsule/commands/presentations.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 38-44 are not covered by tests (advisory).


class HandOffCommand(Command):
name = "hand-off"
help = "Print the recorded presentation's console link for the engineer."

@classmethod
def configure(cls, parser: argparse.ArgumentParser) -> None:
parser.add_argument("folder", type=Path)
parser.add_argument("--project", type=Path, help="Console project root; defaults to PROJECT_PATH or cwd.")
parser.add_argument("--console-url", help="Defaults to DEVCAPSULE_CONSOLE_URL.")
parser.add_argument("--token-file", type=Path, help="Defaults to the capsule console token file.")

Check warning on line 56 in devcapsule-src/devcapsule/commands/presentations.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 53-56 are not covered by tests (advisory).

@classmethod
def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
root = (arguments.project or Path(os.environ.get("PROJECT_PATH") or ".")).resolve()
folder = arguments.folder.resolve()
origin = arguments.console_url or os.environ.get("DEVCAPSULE_CONSOLE_URL", "")
token_path = arguments.token_file or Path(os.environ.get("DEVCAPSULE_CONSOLE_TOKEN_FILE") or "/run/devcapsule-console-token")
try:
token = token_path.read_text(encoding="utf-8").strip()
except (OSError, UnicodeError):
token = ""
try:
if not (folder / "presentation.json").is_file():
raise ValueError(f"no presentation.json in {folder}")
link = presentation_link(folder, project=root, console_url=origin, token=token)
except (OSError, ValueError) as error:
raise CliError(str(error)) from error
if not token:
print("Open the console first to establish a browser session; no readable run token was found.")
print(link)
return 0

Check warning on line 77 in devcapsule-src/devcapsule/commands/presentations.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

Changed executable lines 60-77 are not covered by tests (advisory).


class PresentationsCommand(Group):
name = "presentations"
help = "Record E2E scenarios and make presentations: agent guide, Python toolkit and console link."

@classmethod
def subcommands(cls) -> Mapping[str, type[Command] | type[Group]]:
return {command.name: command for command in (GuideCommand, ExportCommand, HandOffCommand)}

Check warning on line 86 in devcapsule-src/devcapsule/commands/presentations.py

View workflow job for this annotation

GitHub Actions / Python 3.12

Uncovered changed lines

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


COMMAND = PresentationsCommand
5 changes: 3 additions & 2 deletions devcapsule-src/devcapsule/commands/project.py
Original file line number Diff line number Diff line change
Expand Up @@ -1236,7 +1236,7 @@ def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
class ConfigDenyCommand(Command):
name = "deny"
capsule_access: ClassVar[CapsuleAccess] = CapsuleAccess.MUTATES
help = "Deny a host access for this checkout, recorded: network, docker-daemon, development-sudo, host-browser, host-x11."
help = "Deny a host access for this checkout, recorded: network, docker-daemon, development-sudo, host-browser, host-x11, github-ssh."

@classmethod
def configure(cls, parser: argparse.ArgumentParser) -> None:
Expand Down 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
})
6 changes: 5 additions & 1 deletion devcapsule-src/devcapsule/configuration/review.py
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,16 @@
from .trust import HomeTrust
from .values import RuntimeEffects, resolve_configuration_values

__all__ = ["HostAccess", "ConfigurationReview", "review_configuration"]


@dataclass(frozen=True)
class HostAccess:
"""Effective host decisions; absence has a safe, explicit interpretation."""
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 +38,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 +131,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