rosotacom-dev 2.2__tar.gz

rosotacom_dev-2.2/.devcontainer/devcontainer.json.template

@@ -0,0 +1,25 @@
+// See https://containers.dev/implementors/json_reference/
+{
+	"image": "#image_name",
+	"initializeCommand": "ros2docker build -f ./ros2docker.json",
+	"postCreateCommand": "/entrypoint.sh",
+	"workspaceMount": "",
+	"workspaceFolder": "/ws",
+	"runArgs": [
+		#docker_run_args,
+	],
+    "customizations": {
+        "vscode": {
+            "extensions": [
+				"ms-vscode.cpptools",
+				"ms-vscode.cpptools-themes",
+				"twxs.cmake",
+				"ms-python.python",
+				"ms-python.debugpy",
+				"ms-python.vscode-pylance",
+				"ms-iot.vscode-ros",
+				"mhutchie.git-graph"
+            ]
+        }
+    }
+}

rosotacom_dev-2.2/.devcontainer/re_generate_devcontainer_json.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+
+import os
+import stat
+
+script_dir = os.path.dirname(os.path.abspath(__file__))
+project_dir = os.path.dirname(script_dir)
+config_path = os.path.join(project_dir, "ros2docker.json")
+
+from ros2docker.commands import make_run_command
+from ros2docker.config import load_config, strip_json_comments
+
+
+def generate_file_from_template(template_path, output_path, substitutions):
+    with open(template_path, "r", encoding="utf-8") as file:
+        content = file.read()
+    for key, value in substitutions.items():
+        content = content.replace(key, value)
+    content = strip_json_comments(content)
+    content = "\n".join(line for line in content.splitlines() if line.strip())
+    if os.path.exists(output_path):
+        os.remove(output_path)
+    with open(output_path, "w", encoding="utf-8") as file:
+        file.write(content)
+    os.chmod(output_path, stat.S_IRUSR | stat.S_IRGRP | stat.S_IROTH)
+
+
+def main():
+    # Save the contents of the vsc-template-files
+    devcontainer_template_file = os.path.join(script_dir, "devcontainer.json.template")
+    devcontainer_file = os.path.join(script_dir, "devcontainer.json")
+
+    local_config = load_config(config_path)
+    run_command = make_run_command(config_path, override={"run_type": "up"})
+    image_name = local_config.get("image_name", "ros2docker")
+    image_index = run_command.index(image_name)
+    docker_run_args = run_command[2:image_index]
+    if docker_run_args and docker_run_args[-1] == "-d":
+        docker_run_args = docker_run_args[:-1]
+
+    substitutions = {
+        "#docker_run_args": str(docker_run_args).replace("'", '"')[1:-1],
+        "#image_name": str(image_name),
+    }
+    generate_file_from_template(devcontainer_template_file, devcontainer_file, substitutions)
+
+if __name__ == "__main__":
+    main()

rosotacom_dev-2.2/.github/CODEOWNERS

@@ -0,0 +1,8 @@
+# CODEOWNERS file for ros_communication_devcontainer
+# High-risk CI, release, and packaging surfaces
+/.github/                     @develNor
+/pyproject.toml               @develNor
+/justfile                     @develNor
+/docs/release.md              @develNor
+/docs/release-notes/          @develNor
+/src/rosotacom/resources/     @develNor

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/documentation-audit.md

@@ -0,0 +1,67 @@
+---
+name: Documentation audit
+about: Align public-facing documentation with the repository and remove drift.
+title: "Audit public-facing documentation"
+labels: ready, documentation
+assignees: ""
+---
+
+## Goal
+
+Make public-facing documentation consistent, non-redundant, aligned with the
+repository, and no larger than it needs to be. Every document and section should
+earn its place or be removed or merged into its canonical home.
+
+## Scope
+
+- README.
+- CONTRIBUTING.
+- DEVELOPMENT_PRINCIPLES.
+- docs/.
+- `.github/ISSUE_TEMPLATE/`.
+- Package metadata if it contains public-facing descriptions.
+
+## Document Ownership
+
+Audit against the ownership map in
+[docs/quality-model.md](../../docs/quality-model.md#document-ownership). Do not
+restate that map here.
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Prefer one canonical location plus links instead of repeated prose.
+- Remove or merge documents or sections that do not earn their place.
+- Do not change source code unless needed to correct a documented command.
+
+## Tasks
+
+- [ ] Find duplicated, stale, contradictory, or misplaced information.
+- [ ] Justify or delete each document and major section.
+- [ ] Keep public docs generic: no private hostnames, credentials, or local
+      operator details.
+- [ ] Ensure documented workflows match actual repo configuration.
+- [ ] Ensure links resolve.
+- [ ] Ensure contributor workflow instructions do not diverge between docs and
+      templates.
+
+## Acceptance Criteria
+
+- [ ] Public docs have clear ownership and no accidental policy duplication.
+- [ ] Documents or sections that did not earn their place were removed or merged.
+- [ ] README, CONTRIBUTING, DEVELOPMENT_PRINCIPLES, issue templates, and docs
+      links resolve.
+- [ ] Remaining duplication is intentional and recorded in the PR.
+
+## Checks
+
+- [ ] `just docs`
+- [ ] `just lint`
+
+## Final Report
+
+- Final responsibility of each public-facing document:
+- Moved or removed duplicated content:
+- Remaining intentional duplication:
+- Documented behavior that still lacks implementation or tests:
+- Commands run:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/implementation-cleanup.md

@@ -0,0 +1,60 @@
+---
+name: Implementation cleanup
+about: Simplify implementation while preserving the public contract.
+title: "Clean up implementation"
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Improve implementation quality while preserving the current public contract.
+
+## Scope
+
+- Source code.
+- Tests only where needed to preserve or clarify behavior.
+- Documentation only for small corrections caused by code cleanup.
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Do not change documented CLI/config/Docker behavior unless tests and docs prove
+  the old behavior was stale or broken.
+- Do not remove tests or weaken assertions.
+- Do not add compatibility layers unless explicitly required.
+- Prefer clean removal of obsolete or dead code.
+- Avoid broad rewrites.
+
+## Tasks
+
+- [ ] Check for dead code and unused imports.
+- [ ] Check for duplicated logic and redundant branches.
+- [ ] Check for over-abstracted helpers and unclear names.
+- [ ] Check for unnecessary compatibility paths.
+- [ ] Check for unnecessarily complicated control flow.
+- [ ] Check for tests that no longer test meaningful behavior.
+
+## Acceptance Criteria
+
+- [ ] Public CLI/config/Docker behavior is preserved unless explicitly documented
+      and tested.
+- [ ] Simplifications are focused and reviewable.
+- [ ] Existing tests remain meaningful.
+
+## Checks
+
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just test-e2e-smoke`, if Docker/runtime behavior changed.
+
+## Final Report
+
+- Simplifications made:
+- Public behavior preserved:
+- Tests changed:
+- Commands run:
+- Remaining risks or follow-up:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/quality-workflow.md

@@ -0,0 +1,68 @@
+---
+name: Quality workflow
+about: Run the multi-PR repository quality workflow.
+title: "Run repository quality workflow"
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Run the repository quality pass: diagnose first, then create one focused PR for
+each actionable finding the diagnosis triages. A healthy repository may yield no
+PRs at all; that is a successful outcome.
+
+## Autonomous Mode
+
+- [ ] This issue explicitly requests autonomous PR creation and auto-merge.
+
+If autonomous mode is not checked, open draft review PRs by default and stop
+after each PR is ready for review.
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Create one focused PR per goal.
+- Do not combine unrelated goals into one PR.
+- Start each implementation goal from latest `origin/develop` unless the
+  diagnosis names a release or `main`-promotion task.
+- Do not start a dependent goal until prerequisite PRs merge.
+- If CI fails, fix the current PR instead of starting a new goal.
+- If a PR cannot be merged automatically, stop and report the blocker.
+
+## Execution Plan
+
+- [ ] Create and complete an issue from
+      [repository-diagnosis.md](repository-diagnosis.md). This read-only pass
+      triages findings by altitude and disposition and proposes the issues to
+      open. If it finds nothing actionable, report that and stop here.
+- [ ] For each actionable finding, in the diagnosis's priority order, create and
+      complete one focused issue using the leaf template it names:
+      [test-ci-audit.md](test-ci-audit.md),
+      [documentation-audit.md](documentation-audit.md),
+      [implementation-cleanup.md](implementation-cleanup.md),
+      [redesign.md](redesign.md),
+      [release-process.md](release-process.md), or [work-item.md](work-item.md).
+
+## Acceptance Criteria
+
+- [ ] The diagnosis ran first and its triage is recorded.
+- [ ] Each actionable goal has a separate issue and PR.
+- [ ] Each PR links its issue and reports checks run.
+- [ ] Dependent goals start only after prerequisite PRs merge.
+- [ ] If the diagnosis found no action, the final report records that outcome and
+      the probes that support it.
+
+## Checks
+
+Use the checks listed in each generated issue template.
+
+## Final Report
+
+- Diagnosis summary or no-action result:
+- Issues created:
+- PRs created:
+- PR URLs and CI status:
+- Merged PRs:
+- Net line delta for product vs. governance/process changes:
+- Blockers:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/redesign.md

@@ -0,0 +1,59 @@
+---
+name: Redesign
+about: Bold, cross-cutting redesign of one diagnosed concern, backed by tests.
+title: "Redesign: "
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Redesign the specific concern named by the
+[repository diagnosis](repository-diagnosis.md). This is for one coherent
+vertical slice when a finding spans code, tests, docs, and naming together.
+
+## Scope
+
+- The single diagnosed concern.
+- Code, tests, docs, examples, and packaging only where that concern reaches.
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Be bold inside the diagnosed scope; do not expand beyond it.
+- Prefer clean removal, renaming, or restructuring over compatibility shims.
+- Public behavior changes must update tests and docs in the same PR.
+- Do not weaken Docker/runtime checks when the redesign touches runtime behavior.
+
+## Tasks
+
+- [ ] Restate the diagnosis and target shape.
+- [ ] Make one coherent vertical-slice change.
+- [ ] Update README, docs, examples, schemas, and tests for public behavior.
+- [ ] Remove obsolete code or docs created by the old shape.
+
+## Acceptance Criteria
+
+- [ ] The diagnosed concern is resolved.
+- [ ] Tests cover the new shape.
+- [ ] Public behavior changes are documented.
+- [ ] The PR stays inside the diagnosed scope.
+
+## Checks
+
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just check`
+- [ ] `just test-e2e-smoke`, if Docker/runtime behavior changed.
+
+## Final Report
+
+- Concern redesigned:
+- Target shape:
+- Code / tests / docs changed:
+- Public behavior changes:
+- Commands run:
+- Remaining risks or follow-up:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/release-process.md

@@ -0,0 +1,89 @@
+---
+name: Release process
+about: Prepare, validate, describe, and publish a rosotacom release.
+title: "Prepare release vX.Y.Z"
+labels: ready, documentation
+assignees: ""
+---
+
+## Goal
+
+Ship a validated, well-described `rosotacom` release.
+
+## Use When
+
+A maintainer is preparing a new `vX.Y.Z` tag, package release, and GitHub
+Release. This is the executable checklist for the release entrypoint in
+[docs/owner-runbook.md](../../docs/owner-runbook.md#prepare-a-release).
+
+## Target
+
+- Target tag: `vX.Y.Z`
+- `main` commit SHA:
+- Previous release tag:
+- Promotion/validation evidence:
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Start from the exact validated `main` commit when preparing release notes.
+- Do not tag or publish until the release PR has merged.
+- Open a draft review PR by default unless autonomous release work is explicitly
+  requested.
+- Keep external OTA gate evidence generic; do not record private hostnames,
+  credentials, or deployment details.
+- Update docs/tests if public CLI, config, Docker, or runtime behavior changed.
+
+## Tasks
+
+- [ ] Choose the target tag in the form `vX.Y.Z`.
+- [ ] Identify the previous release tag.
+- [ ] Confirm the release commit is on `main` and record its exact SHA.
+- [ ] Review all commits and the full diff since the previous release.
+- [ ] Summarize user-facing CLI, config, Docker, dependency, and packaging changes.
+- [ ] Copy `docs/release-notes/TEMPLATE.md` to `docs/release-notes/vX.Y.Z.md`.
+- [ ] State breaking changes and migration steps, or explicitly say there are none.
+- [ ] Include local command results in the PR description.
+- [ ] After merge, have a maintainer tag the release commit and push the tag.
+- [ ] Confirm the tag workflow succeeded for the exact recorded SHA.
+- [ ] Confirm the configured package deployment succeeded.
+- [ ] Inspect the wheel, source distribution, checksums, and GitHub Release.
+- [ ] Record release, workflow, and deployment links.
+- [ ] Do not create a downstream sync PR until all release evidence is reviewed.
+
+## Acceptance Criteria
+
+- [ ] Release notes exist for the target tag.
+- [ ] Compatibility, migration, Docker/runtime, dependency, packaging, and
+      validation notes are explicit.
+- [ ] The release workflow validates and publishes from the tag.
+
+## Checks
+
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just package`
+- [ ] `just test-e2e-smoke`
+
+## Evidence
+
+- Release PR:
+- GitHub Release:
+- Release workflow:
+- Deployment:
+- Artifacts inspected:
+
+## Final Report
+
+- Previous release tag:
+- Target release tag:
+- Release notes file path:
+- User-facing changes:
+- Compatibility or migration notes:
+- Docker/runtime or dependency updates:
+- Commands run:
+- PR URL and CI status:
+- Final package and GitHub Release status after tagging:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/repository-diagnosis.md

@@ -0,0 +1,104 @@
+---
+name: Repository diagnosis
+about: Read-only diagnosis and triage that decides what, if anything, the repo needs.
+title: "Diagnose repository and triage follow-up work"
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Take in the whole repository and produce a prioritized diagnosis that decides
+what work, if any, the repository needs. This is the planning keystone of the
+quality pass: it routes work, it does not edit files.
+
+## How This Fits
+
+This runs first in the soft-check pass described by
+[docs/quality-model.md](../../docs/quality-model.md). The
+[quality-workflow](quality-workflow.md) orchestrator then creates and completes
+exactly the issues this triage names. It may name none.
+
+## Constraints
+
+- Read-only: do not change code, docs, tests, or config in this task.
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract);
+  only the quality, tracking, and reporting parts apply because this task opens
+  no PR.
+- Classify by what a finding needs, not by the smallest patch available.
+- "No action needed" is valid only when it names the probes that would have
+  caught a problem.
+- Keep public findings generic. Do not include private hostnames, credentials,
+  or operator-specific deployment details.
+
+## Diagnose Along Two Axes
+
+Altitude:
+
+- Vision.
+- Architecture.
+- Module / interface.
+- Line / local.
+- Meta / governance.
+
+Disposition:
+
+- None.
+- Inline.
+- Scoped.
+- Redesign.
+
+Use [docs/quality-model.md](../../docs/quality-model.md#diagnosis-first) for the
+meaning of each axis and disposition.
+
+## Lenses
+
+- Value / proportionality: every doc, template, and process step must be
+  load-bearing for an owner-visible outcome.
+- Generality: public docs use roles and generic external-gate language, not
+  private deployment details.
+- Drift: documented commands, checks, CI, release steps, and RFC state match the
+  repository.
+- Runtime relevance: Docker smoke, packaged examples, ROS/catmux resources, and
+  external OTA gates are distinct and should not be conflated.
+
+## Tasks
+
+- [ ] Read top-down: README, CONTRIBUTING, development principles, docs, issue
+      templates, tests, package config, source, and workflows.
+- [ ] Record findings with altitude, disposition, target template, and rationale.
+- [ ] Include an explicit "no action" section with the probes that found healthy
+      areas.
+- [ ] Check product vs. governance/process size and whether the governance layer
+      earns its current size.
+- [ ] For each reusable issue template, state the owner-visible outcome that
+      would change if it were deleted.
+- [ ] Check RFC implementation and validation checklists for drift.
+- [ ] Order actionable findings by priority and dependencies.
+- [ ] Propose one issue per actionable finding, naming the template to use.
+- [ ] If nothing is actionable, say so explicitly.
+
+## Acceptance Criteria
+
+- [ ] Every finding has an altitude and disposition.
+- [ ] Every actionable finding maps to one proposed issue and template.
+- [ ] Every `None` disposition cites a meaningful probe.
+- [ ] The report distinguishes public GitHub checks from external OTA promotion
+      gates.
+- [ ] The report includes product-vs-governance proportionality and issue-template
+      reachability/load-bearing notes.
+- [ ] No files were changed by this task.
+
+## Final Report
+
+Triage table:
+
+| Finding | Altitude | Disposition | Target template | Rationale |
+| --- | --- | --- | --- | --- |
+
+- No action needed, with probes:
+- Product vs. governance/process size verdict:
+- Issue-template load-bearing notes:
+- RFC validation drift:
+- Proposed issues, in priority order:
+- Dependencies:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/test-ci-audit.md

@@ -0,0 +1,61 @@
+---
+name: Test and CI audit
+about: Audit tests, CI wiring, and coverage of documented behavior.
+title: "Audit test and CI coverage"
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Audit and improve test coverage and test execution wiring.
+
+## Scope
+
+- tests/.
+- pyproject.toml.
+- .pre-commit-config.yaml.
+- .github/workflows/*.
+- README and docs that describe testing.
+- Minimal source changes only if required to make behavior testable.
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Do not refactor implementation except where needed to make tests possible.
+
+## Tasks
+
+- [ ] Map public README-documented commands, features, and CLI behavior to tests
+      where feasible.
+- [ ] Add missing tests for feasible documented behavior.
+- [ ] Record manual verification for behavior that cannot sensibly be automated.
+- [ ] Verify that tests are collected and actually executed.
+- [ ] Check that tests are not accidentally skipped, deselected, ignored, or
+      excluded by config.
+- [ ] Ensure skipped/xfail tests have explicit reasons.
+- [ ] Verify that local commands, pre-commit, CI, and release validation agree.
+
+## Acceptance Criteria
+
+- [ ] Documented public behavior has automated coverage or a recorded manual
+      verification reason.
+- [ ] Local test commands and CI workflows agree on the intended gates.
+- [ ] Changed behavior includes tests before the PR is marked ready.
+
+## Checks
+
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just check`
+- [ ] `just test-e2e-smoke`
+
+## Final Report
+
+- Changed files:
+- Added or fixed tests:
+- Remaining untested behavior and why:
+- Commands run:

rosotacom_dev-2.2/.github/ISSUE_TEMPLATE/work-item.md

@@ -0,0 +1,46 @@
+---
+name: Work item
+about: Track actionable project work that should be handled through an issue and PR.
+title: ""
+labels: ready
+assignees: ""
+---
+
+## Goal
+
+Describe the outcome this issue should achieve.
+
+## Scope
+
+- In scope:
+- Out of scope:
+
+## Constraints
+
+- Follow the shared [task contract](../../docs/quality-model.md#task-contract).
+- Keep the change small and coherent.
+- Do not skip, weaken, or delete tests/CI to make this pass.
+
+## Acceptance Criteria
+
+- [ ] The requested behavior or documentation exists.
+- [ ] Public behavior changes update README, docs, examples, packaging, and tests where applicable.
+- [ ] The PR links this issue.
+- [ ] The PR body records local checks and manual verification.
+
+## Checks
+
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just check`
+- [ ] `just test-e2e-smoke`, if Docker/runtime behavior changed.
+
+## Final Report
+
+- Changed files:
+- Behavior or documentation changed:
+- Checks run:
+- Remaining risks or follow-up:

rosotacom_dev-2.2/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,43 @@
+## Summary
+
+-
+
+## Linked Issue
+
+- Fixes #
+
+## Release Notes
+
+- [ ] Release PR: includes `docs/release-notes/vX.Y.Z.md`
+- [ ] Release PR: summarizes user-facing changes since the previous release
+- [ ] Release PR: documents compatibility, migration, and validation notes
+- [ ] Release PR: records the intended `main` commit and previous release tag
+- [ ] Not a release PR
+
+## Public Behavior
+
+- [ ] Changes public CLI/config/API/Docker behavior
+- [ ] Does not change public behavior
+
+## Checks
+
+- [ ] `just lint-workflows`
+- [ ] `just lint-build`
+- [ ] `just lint`
+- [ ] `just typecheck`
+- [ ] `just test-unit`
+- [ ] `just test-contract`
+- [ ] `just docs`
+- [ ] `just package`
+- [ ] `just check`
+- [ ] `just test-e2e-smoke`, if Docker/runtime behavior changed
+
+## Test Integrity
+
+- [ ] Tests/CI were not skipped, weakened, or removed to make this pass
+
+## Maintainer Evidence
+
+- Required CI links:
+- Manual/runtime evidence:
+- External OTA evidence, if this PR is part of a `main` promotion: