Skip to content

NET spec: amend NET-122, NET-079, NET-018/020 for finalize-install and one-line start; rule on NET-078 un-enrolled identities #2135

Closed

Description

@norrietaylor

Problem statement

#2127, #2128, #2129, #2130 and #2131 change behaviour that requirements in docs/specs/18-spec-box-networking bind verbatim. The spec has to move with them. One amendment needs an architecture ruling first.

Proposed solution

Requirement Amendment
NET-122 and its sub-requirements Replace min net setup with min finalize-install, and --print with --show plus --show --script. Widen the scope to the userns profile and the classifier. The session-start pointer names min finalize-install.
NET-122 (new sub-requirement) WHEN the installer completes on a TTY and the host lacks a step, THE SYSTEM SHALL show the summary and offer the step. It SHALL NOT prompt on a host that needs nothing.
NET-079, advisory sub-requirement WHILE the box declares egress only. The command is min finalize-install, never a placeholder or a remote fetch.
NET-078 Architecture ruling needed: may an un-enrolled host omit the cohort and node-plane source identities, given that no gateway reads them until enrolment? If yes, they move to the enrolled-host egress document. #2128 depends on this.
NET-018, NET-020, NET-026 The activate surface is one host line. min ls keeps the detail rows.
(new) THE SYSTEM SHALL report a sandbox the host refuses at activation, before session creation, with its cause and remedy.

Source: the spec-amendment section in crosswalk.md.

Alternatives considered

  • Leave the spec and change only the code: the requirements' verify tests pin the current strings, so the code cannot move alone.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions