Skip to content
Merged
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
7955cce
Open the linux-arm64 workstream with its design note
powerofsoul Nov 4, 2026
c5d6278
Open the macos-launcher workstream with its design note
powerofsoul Nov 3, 2026
0914467
Run the launcher on macOS against linux-amd64 capsules
powerofsoul Nov 3, 2026
b4c99ff
Fall back to bridge networking on macOS
powerofsoul Nov 3, 2026
c25e381
Pass the PyCharm smoke on macOS and record the live launch
powerofsoul Nov 3, 2026
40d3e45
Document the experimental macOS launcher built from source
powerofsoul Nov 3, 2026
6b2c66e
Give development sudo a root-owned policy on macOS
powerofsoul Nov 4, 2026
dc88f48
Record the macOS development-sudo fix in the workstream
powerofsoul Nov 4, 2026
e8e67a1
Add linux-arm64 as a second capsule platform
powerofsoul Nov 4, 2026
b679461
Pin the locally built arm64 base and let a command name its platform
powerofsoul Nov 4, 2026
667d00e
Pin every component's arm64 build for linux-arm64
powerofsoul Nov 4, 2026
86fbff8
Re-pin a checkout's personal choices for the platform it runs as
powerofsoul Nov 4, 2026
30cb5c7
Add libunwind8 to the arm64 Eclipse package closure
powerofsoul Nov 4, 2026
f14f32b
Record linux-arm64 slices 1 to 3 and document --platform
powerofsoul Nov 4, 2026
e2e2fbc
Fix the review of the macOS and linux-arm64 branch
powerofsoul Nov 4, 2026
868369b
Remap a personal pin that is another platform's embedded table
powerofsoul Nov 4, 2026
398fc3c
Let the IDE smoke create its project for a named platform; record the…
powerofsoul Nov 4, 2026
eb53ce9
Run a project as the platform its locks name; regenerate every lock
powerofsoul Nov 4, 2026
5f3f874
Record the native arm64 smokes and the second review's fixes
powerofsoul Nov 4, 2026
dcc2a7d
Ask a host of several platforms which one a new project is for
powerofsoul Nov 4, 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
2 changes: 2 additions & 0 deletions CURRENT-STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,8 @@ coordination branch. Detailed state belongs in each linked status file.
| `website` | 2026-09-16 | Deliver the website autonomy experiment: repository-owned landing/docs/blog content, independently developable website submodule, local preview and publishing mechanism | paused 2026-09-30; producer migration merged in PR #152 and the versioned documentation live; W04-C, W09-C, W11-C retained | `ws-website/contract-v1` | [workstream status](engineering-docs/wip/2026-09-16-website/CURRENT-STATUS.md) |
| `capsule-webconsole` | 2026-10-09 | Serve a token-gated web console from every capsule: configuration, versions, info, live resources, later records and workflow state | active; work order accepted 2026-10-09; the first iteration, deliverables 1 and 2, is three stacked pull requests, #184, #186 and the runtime-and-base slice, each reviewed by the Codex pair; the owner merges | `ws-capsule-webconsole/first-slice` | [workstream status](engineering-docs/wip/2026-10-09-capsule-webconsole/CURRENT-STATUS.md) |
| `wrapped-projects` | 2026-11-02 | Wrap a foreign repository as a submodule of a small wrapper project and work on it in a capsule with three commands; FRC learning project first | active; PR1 (#333) accepted by the owner 2026-11-03, awaiting merge; the project-capabilities design handed to workflow-improvements | `ws-wrapped-projects/wrap` | [workstream status](engineering-docs/wip/2026-11-02-wrapped-projects/CURRENT-STATUS.md) |
| `macos-launcher` | 2026-11-03 | Run the DevCapsule launcher natively on Apple Silicon Macs against Docker Desktop, with capsules as `linux-amd64` under emulation | active 2026-11-03; slices 1 to 4 done, the PyCharm smoke passing on an Apple Silicon Mac; waits on publication and the owner's rulings | `ws-macos-launcher/host-port` | [workstream status](engineering-docs/wip/2026-11-03-macos-launcher/CURRENT-STATUS.md) |
| `linux-arm64` | 2026-11-04 | Run capsules as `linux-arm64` as well as `linux-amd64`: natively on Apple Silicon Macs and on ARM Linux hosts | active 2026-11-04; slices 1 to 4 done, six IDEs running natively on Apple Silicon; waits on publication, the owner's arm64 base and rulings | `ws-linux-arm64/capsules` | [workstream status](engineering-docs/wip/2026-11-04-linux-arm64/CURRENT-STATUS.md) |
| `website` | 2026-09-16 | Deliver the website autonomy experiment: repository-owned landing/docs/blog content, independently developable website submodule, local preview and publishing mechanism | paused 2026-09-20 at owner request to switch to maintenance; experiment accepted, A−; blog integrated and published; content/parent-integration follow-ups remain | `ws-website/initial-cut`; renamed from `website/initial-cut`; preparation and backlog-handoff exceptions in status | [workstream status](engineering-docs/wip/2026-09-16-website/CURRENT-STATUS.md) |

Paused and blocked workstreams remain open until they conclude successfully or
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,11 @@
set -euo pipefail

IDE_HOME="${IDE_HOME:-${PYCHARM_HOME:-/opt/pycharm}}"
SKIKO_LIB="$IDE_HOME/lib/skiko-awt-runtime-all/libskiko-linux-x64.so"
case "$(uname -m)" in
aarch64 | arm64) SKIKO_ARCH=arm64 ;;
*) SKIKO_ARCH=x64 ;;
esac
SKIKO_LIB="$IDE_HOME/lib/skiko-awt-runtime-all/libskiko-linux-$SKIKO_ARCH.so"
FAILURES=0

pass() {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,11 @@
set -euo pipefail

IDE_HOME="${IDE_HOME:-${PYCHARM_HOME:-/opt/pycharm}}"
SKIKO_LIB="$IDE_HOME/lib/skiko-awt-runtime-all/libskiko-linux-x64.so"
case "$(uname -m)" in
aarch64 | arm64) SKIKO_ARCH=arm64 ;;
*) SKIKO_ARCH=x64 ;;
esac
SKIKO_LIB="$IDE_HOME/lib/skiko-awt-runtime-all/libskiko-linux-$SKIKO_ARCH.so"
FAILURES=0

pass() {
Expand Down
20 changes: 18 additions & 2 deletions devcapsule-src/devcapsule/commands/framework.py
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,9 @@

- The framework owns the command *tree*: discovery-independent group dispatch,
group help, hidden commands, group-scoped options such as
``project --path``, and the carrier-option grammar shared by ``init``,
``run``, and the ``config`` family.
``project --path``, the carrier-option grammar shared by ``init``,
``run``, and the ``config`` family, and the ``--platform`` value shared by
``project init`` and ``images build``.
- :mod:`argparse` owns only *leaf* option parsing, declared per command in
``configure``.

Expand All @@ -31,6 +32,7 @@
from typing import Any, ClassVar, Mapping, NoReturn, Sequence

from devcapsule.compat import CliError
from devcapsule.platforms import Platform, UnsupportedPlatformError


class UsageError(CliError):
Expand Down Expand Up @@ -303,3 +305,17 @@ def carrier_answers(
)
)
return tuple(answers)


def capsule_platform_argument(value: str) -> Platform:
"""A ``--platform`` value: a capsule platform this host runs."""

try:
platform = Platform.parse(value)
runnable = Platform.runnable()
except UnsupportedPlatformError as exc:
raise argparse.ArgumentTypeError(str(exc)) from exc
if platform not in runnable:
names = ", ".join(str(member) for member in runnable)
raise argparse.ArgumentTypeError(f"this host runs {names} capsules, not {platform}")
return platform
14 changes: 13 additions & 1 deletion devcapsule-src/devcapsule/commands/images.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,11 +19,12 @@
build_base_image,
resolved_root_image,
)
from devcapsule.commands.framework import Command, Group
from devcapsule.commands.framework import Command, Group, capsule_platform_argument
from devcapsule.compat import CliError
from devcapsule.environment_realization import optional_local_image, realize_environment
from devcapsule.images.metadata import LocalImageRecord, inspect_local_image, list_local_images
from devcapsule.materialization import ImageDetails
from devcapsule.platforms import Platform
from devcapsule.configuration.execution import (
fresh_resolved_project,
)
Expand Down Expand Up @@ -110,10 +111,20 @@ def configure(cls, parser: argparse.ArgumentParser) -> None:
default="default",
help="Build network mode forwarded to Docker buildx (default: default).",
)
parser.add_argument(
"--platform",
dest="capsule_platform",
type=capsule_platform_argument,
metavar="PLATFORM",
help="Capsule platform of a base build, such as linux-arm64; default: the one this host "
"creates projects for. An environment build is for its project's platform.",
)

@classmethod
def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
if arguments.image_type == "environment":
if arguments.capsule_platform is not None:
raise CliError("--platform applies only to base builds; an environment build is for its project's platform.")
return _build_environment(
project=arguments.project,
base_override=arguments.base_override,
Expand Down Expand Up @@ -153,6 +164,7 @@ def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
build_base_image(
options,
network=arguments.network,
platform=arguments.capsule_platform or Platform.current(),
)
image = inspect_local_image(arguments.tag)
labels = dict(image.config.labels or {})
Expand Down
17 changes: 13 additions & 4 deletions devcapsule-src/devcapsule/commands/project.py
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@
Command,
Group,
add_carrier_options,
capsule_platform_argument,
carrier_answers,
)
from devcapsule.components.catalog import COMPONENTS
Expand All @@ -54,6 +55,7 @@
from devcapsule.runtime_configuration import CapsuleAccess
from devcapsule.compat import CliError, DecisionPending
import difflib
from devcapsule.configuration.capability_selection import lock_platform
from devcapsule.configuration.capabilities import CapabilityPolicy, LocalCapabilities
from devcapsule.configuration.console_requests import deferred_rows
from devcapsule.configuration.listing import Listing, assess_checkout
Expand Down Expand Up @@ -310,6 +312,11 @@ def configure(cls, parser: argparse.ArgumentParser) -> None:
help="A capability the project offers and a developer may leave out, such as browser-automation. Repeatable.",
)
_add_owner_options(parser)
parser.add_argument(
"--platform", type=capsule_platform_argument, metavar="PLATFORM",
help="Add the lock for this capsule platform, such as linux-arm64; the project then runs as it here. "
"Default: the platform this host runs the project as.",
)
_retired_option(parser, "--agent", "devcapsule project init --with CAPABILITY")
parser.add_argument(
"--regenerate",
Expand Down Expand Up @@ -351,6 +358,7 @@ def run(cls, arguments: argparse.Namespace, context: object | None) -> int:
answers=answers,
regenerate=arguments.regenerate,
allow_unverified=arguments.allow_unverified,
platform=arguments.platform,
)
)
print(report.render())
Expand Down Expand Up @@ -755,9 +763,9 @@ def _load_checkout_documents(context: object | None) -> CheckoutDocuments | runt
def _assess(documents: CheckoutDocuments) -> Listing:
from devcapsule.configuration.authorization import authorized_base_selection
from devcapsule.configuration.trust import HomeTrust
from devcapsule.platforms import Platform
from devcapsule.configuration.storage import project_platform
from devcapsule.resolution_matrix import MATRICES, known_base_image
matrix = MATRICES[Platform.current()]
matrix = MATRICES[project_platform(documents.root)]
answers = documents.checkout.get("authorization", {})
base_answer = answers.get("base-image", {}) if isinstance(answers, dict) else {}
base_reference = base_answer.get("reference") if isinstance(base_answer, dict) else None
Expand Down Expand Up @@ -1702,12 +1710,12 @@ def run(cls, arguments: argparse.Namespace, context: object | None) -> int:

def _local_selection(context: object | None) -> tuple[Path, dict[str, Any], LocalCapabilities, dict[str, str]]:
"""The checkout's current selection and the catalog's IDE names, for the selection verbs."""
from devcapsule.platforms import Platform
from devcapsule.configuration.storage import project_platform
from devcapsule.resolution_matrix import MATRICES
root, manifest = manifest_for(_project_context(context).start_path())
record = find_checkout_record(manifest, root)
current = LocalCapabilities.read(load_checkout(record, manifest, root)) if record is not None else LocalCapabilities()
matrix = MATRICES[Platform.current()]
matrix = MATRICES[project_platform(root)]
surfaces = {name: matrix.resolve_provider(name) or name for name in matrix.ide_capabilities()}
return root, manifest, current, surfaces

Expand Down Expand Up @@ -2436,6 +2444,7 @@ def prepare_display(base: ImageDetails) -> None:
enable_host_browser=selected_host_browser,
display_transport=display_transport,
web_console=web_console,
capsule_platform=lock_platform(lock),
)
)
if command_report is not None:
Expand Down
3 changes: 2 additions & 1 deletion devcapsule-src/devcapsule/components/codex.py
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,8 @@ class CodexComponent(ComponentDefinition):
"""Trusted Codex component implementation."""

def distribution_channel(self) -> NpmChannel:
return NpmChannel(CODEX_PACKAGE, {"linux-amd64": "@openai/codex-linux-x64"})
return NpmChannel(CODEX_PACKAGE, {"linux-amd64": "@openai/codex-linux-x64",
"linux-arm64": "@openai/codex-linux-arm64"})

@property
def id(self) -> str:
Expand Down
4 changes: 2 additions & 2 deletions devcapsule-src/devcapsule/components/eclipse.py
Original file line number Diff line number Diff line change
Expand Up @@ -59,8 +59,8 @@ def locked_artifacts(self, metadata: Mapping[str, object], platform: str) -> tup
# dependencies use the same acquisition/hash verification before an
# offline dpkg installation. The set is specific to the Ubuntu 24.04 base.
packages = metadata.get("native-packages")
if platform != "linux-amd64" or not isinstance(packages, dict) or not packages:
raise CliError("Eclipse requires pinned native-packages for linux-amd64.")
if platform not in ("linux-amd64", "linux-arm64") or not isinstance(packages, dict) or not packages:
raise CliError(f"Eclipse requires pinned native-packages for {platform}.")
artifacts = []
for package, entry in packages.items():
if not isinstance(entry, dict) or any(not isinstance(entry.get(key), str) or not entry[key]
Expand Down
Loading
Loading