LearnNewsExamplesServices
Frontmatter
id11837
titleSub 5: External-user configurability audit (forks, npx neo-app workspaces, non-Neo-team clients)
stateClosed
labels
enhancementaiarchitecture
assigneesneo-opus-ada
createdAtMay 23, 2026, 1:22 PM
updatedAtJun 7, 2026, 7:14 PM
githubUrlhttps://github.com/neomjs/neo/issues/11837
authorneo-opus-ada
commentsCount3
parentIssue11831
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtJun 6, 2026, 10:21 PM

Sub 5: External-user configurability audit (forks, npx neo-app workspaces, non-Neo-team clients)

Closed v13.0.0/archive-v13-0-0-chunk-13 enhancementaiarchitecture
neo-opus-ada
neo-opus-ada commented on May 23, 2026, 1:22 PM

Parent Epic

#11831Sub 5 of 6 (parallel after Sub 1).

Scope

Audit the Orchestrator + daemon substrate for Neo-team-specific assumptions that don't survive external deployments (repo forks, npx neo-app workspaces, cloud tenants). Sister concern to ADR 0014 cloud-deployment-topology profile-default precedent.

Acceptance Criteria

  1. Hardcoded Neo-team identities/paths audited: no @neo-opus-ada / @neo-gpt / @neo-gemini-pro literal references in daemon code (only in ai/graph/identityRoots.mjs registry).
  2. Project ID assumptions: no hardcoded "Project 12" / "v13" / release:v* label-as-project-proxy patterns (use aiConfig.currentReleaseProject or substrate resolver).
  3. Path assumptions: all paths resolve relative to checkout root via existing Neo path helpers, never hardcoded to operator's local checkout (/Users/Shared/github/neomjs/neo/).
  4. Local-vs-cloud profile distinction: all daemons honor aiConfig.deploymentProfile (or equivalent) per ADR 0014. Cloud profile disables features that require local Neo-team substrate (e.g., heartbeat-target-list resolution per Discussion #11823 / Epic #11829 AC2).
  5. npx neo-app workspace safety: running daemons from a fresh npx neo-app workspace must not error on missing Neo-team substrate (identityRoots entries, etc.); features that require it MUST disable cleanly with a clear log.

Sister concerns

  • Epic #11829 (wake-driver substrate) Sub 1 (resolveSwarmHeartbeatTargets()) — same external-portability discipline applied to wake-driver
  • ADR 0014 cloud-deployment-topology profile-default precedent

Authored by: [Claude Opus 4.7] (Claude Code)

tobiu referenced in commit 5d428ab - "test(orchestrator): external-config audit invariants AC1-3 + AC4-5 findings (#11837) (#11946) on May 25, 2026, 7:50 AM
tobiu referenced in commit c36ff74 - "feat(orchestrator): add workspace-safety integration test (#11948) (#12011) on May 26, 2026, 9:40 AM