Skip to content

[Acceptance] Complete Organization Intelligence integration and release proof #41

Description

@szmyty

Outcome

Complete the cross-module integration, public/private safety proof, resilience testing, live canaries, documentation, and release closeout needed to call Organization Intelligence a polished finished control plane.

This is the final organization-level acceptance gate under #27 and the master epic #30. Route-specific features remain in their owning issues; this issue begins only when those modules are implementation-complete or explicitly dispositioned.

Entry criteria

Resolve or explicitly disposition:

Scope

Coherent product

  • One organization navigation model, route registry, visual grammar, state vocabulary, filter conventions, evidence drawer, provenance/freshness treatment, and responsive layout.
  • Compact default orientation emphasizing Now, blockers, human decisions, stale/unknown evidence, and next attention.
  • Stable cross-links among organization modules, repository Intelligence routes, canonical sources, and GitHub execution evidence.
  • Preserve route/filter/selected-entity context where useful.
  • Ensure each module answers one distinct primary question.

Public/private safety

  • Visibility filtering before aggregation.
  • Prove that public outputs cannot reveal private repository names, counts, identifiers, routes, issues, findings, dependencies, services, releases, or inferred gaps.
  • Prove separately authorized offline/local private builds.
  • Treat snapshot text as untrusted and allowlist navigable URLs.
  • Document threat model, redaction, and review boundaries.

Failure isolation and freshness

  • One malformed, incompatible, stale, unreachable, or unavailable repository/module must not break the rest of the portal.
  • Last-known context remains visibly stale/provider-unavailable.
  • Snapshot and module schema compatibility errors are actionable.
  • Unknown, stale, partial, blocked, unavailable, incompatible, exempt, redacted, and not-applicable remain explicit.

Accessibility, performance, and visual quality

  • Mobile/desktop layouts, keyboard navigation, screen readers, focus management, reduced motion, high contrast, no color-only state, zoom, and text equivalents.
  • Performance budgets for initial load, large fleet snapshots, graphs, matrices, search, and route transitions.
  • Visual regression fixtures for clean, large, stale, partially adopted, incident-active, finding-heavy, private/redacted, incompatible, and multi-failure states.
  • Direct navigation, refresh, canonical URLs, aliases, sitemap, search index, print, and low/no-JavaScript behavior where promised.

Live proof and operations

  • Prove at least one small, one large/active, and one partially adopted public repository.
  • Prove a mixed organization snapshot with unavailable/stale modules.
  • Verify canonical egohygiene.io hosting, HTTPS, navigation, deployment provenance, rollback, and degraded/static fallback.
  • Verify preview/review artifacts and production deployment use the exact reviewed source state.
  • Document adding/removing a repository, upgrading schema/generator versions, restoring a failed build, and rolling back a publication.

Closeout

  • Reconcile every parent/child checklist and cross-repository dependency against live evidence.
  • Reconcile site navigation, README/architecture/roadmap/continuity, route registry, screenshots, public claims, and operator runbooks.
  • Publish a reviewed release candidate/private preview as appropriate, perform clean smoke tests, then publish the stable public version.
  • Route remaining optional ideas to named post-v1 issues; do not keep the program open for an undefined perfect-forever standard.

Acceptance criteria

Dependencies / related

Non-goals

  • Implementing every route inside this issue.
  • Replacing canonical evidence or GitHub execution.
  • Requiring every repository to reach full conformance before the portal can release.
  • A universal organization score.
  • An authenticated mutation console.

Activity

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

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions