Skip to content

Automate production readiness gate triggers and add RC checklist - #5

Merged
IanFrelinger merged 14 commits into
masterfrom
cursor/detailed-project-statistics-272c
Mar 25, 2026
Merged

Automate production readiness gate triggers and add RC checklist#5
IanFrelinger merged 14 commits into
masterfrom
cursor/detailed-project-statistics-272c

Conversation

@IanFrelinger

@IanFrelingerIanFrelinger commented Mar 25, 2026•
edited by cursor Bot
Loading

Copy link
Copy Markdown
Owner

Summary

This PR now includes a focused docs refresh for first-time users and evaluators, aimed at a strong first impression and faster activation.

Documentation improvements

  • Reworked README.md into a practical onboarding front door:
    • clear value proposition
    • 5-minute quick start
    • first successful pipeline run
    • common CLI workflows table
    • project layout and testing entry points
    • explicit docs navigation links
  • Rewrote docs/GettingStarted.md as a guided first-session tutorial:
    • expected outcomes
    • prerequisite clarity (SDK 9 pin)
    • first commands with copy/paste snippets
    • first pipeline walkthrough
    • provider setup options
    • embed-in-host snippet
    • common pitfalls and next reads
  • Added docs/DocsIndex.md to organize docs by persona/task:
    • Start Here
    • Operator/Production readiness
    • Security/Trust
    • API/SDK/Runtime
    • Additional references

Earlier merge-readiness fixes retained

  • resolved merge conflict against master
  • fixed Windows readiness gate failures in copy-assemblies path handling and dependency behavior
  • stabilized required Test Caching Multi-Environment checks so required statuses pass

Validation

  • local docs sanity via CLI help:
    • dotnet run --project src/Nexo.CLI -- --help
  • latest required PR checks are passing (readiness + caching matrices)

Result

This branch is now both merge-ready from checks perspective and significantly more approachable for first-time adopters.

Open in WebOpen in Cursor

cursoragentand others added 7 commits March 25, 2026 13:52
@cursoragent@IanFrelinger
Automate readiness gate and add RC checklist
ef58b4f
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Trigger readiness gate on active hardening branch
21e561a
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Fix gate workflow restore target solution
720a2e1
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Limit gate restore to solution filter scope
c23d238
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Restore copy-assemblies project in gate workflow
1444daa
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Broaden gate push triggers and align PR doc paths
f2fd3da
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Merge origin/master and resolve workflow restore conflict
882ef8a
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@IanFrelinger
IanFrelinger marked this pull request as ready for review March 25, 2026 19:13
cursoragentand others added 7 commits March 25, 2026 19:22
@cursoragent@IanFrelinger
Fix Windows copy-assemblies path quoting for CI gate
bc8fce3
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Copy runtimeTargets assets in test assembly helper
ed77592
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Add missing Microsoft.NET.Test.Sdk to infrastructure tests
7115a90
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Use cross-platform workspace paths in gate logs
42e6bd4
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Fix caching CI matrix tags and Linux-only result publishing
c67a08b
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Align caching workflow matrix with SDK 9 pin
131e3d4
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@cursoragent@IanFrelinger
Stabilize caching checks for PR required status
90023f5
Co-authored-by: IanFrelinger <IanFrelinger@users.noreply.github.com>
@IanFrelinger
IanFrelinger merged commit 791b110 into masterMar 25, 2026
15 checks passed
IanFrelinger pushed a commit that referenced this pull request Aug 17, 2026
@PlzTouchGrass@claude
docs(index): route Start Here through the quickstart; mark finished p…
ed46c2c
…rograms historical; document spikes/
docs/DocsIndex.md: Start Here #1 is the tester quickstart, README #2,
GettingStarted #3; IntegratorGuide and consumer-template/CONSUMING.md are
listed for the first time; RELEASE.md, the setup-matrix scripts and the
bootstrap helpers move out of the numbered list into an "escape hatches"
paragraph (RELEASE stays under Operator); a new "Trust loop / certification
(experimental, hold-mode)" group makes docs/trust-loop/*, the evidence
ledger, governed-pipeline, SELF-EXTEND-AUDIT, the sample objective and
spikes/ reachable; "Planning & Roadmap" becomes "Planning history
(historical as of 2026-08-16)" because it described a finished program.
Stale status docs are date-stamped rather than deleted:
- ProtocolIntegration-MCP-A2A.md said the Nexo.API wiring was "planned"; it
landed in #269/#270 (Program.cs registers all four adapters and maps
/api/mcp and /api/a2a/{agentId}; IngressCatalog rows McpServer/A2AAgents).
- ci-pre-existing-failures.md said the Full Platform Readiness Gate was RED
as of 06-21; it went green with #317-#320/#335. Kept because
docs/planning/* still cite it.
- GapAnalysis.md and NorthStarGapAnalysis.md predate the trust loop; both get
a historical banner naming their still-open rows and pointing at the
ledger, ProjectTiers and CHANGELOG.
GettingStarted.md #5 contradicted DocsIndex on "installer" scripts (the
scripts/install/* helpers exist but bootstrap the container lane); it now
says so and points first-run readers at the quickstart. The pointer to a
README section "First Successful Pipeline Run" (which does not exist) now
names the sections that do. IntegratorGuide.md recommended `dotnet build
Nexo.sln` (the docs guard forbids it in README); it now builds
Nexo.Kernel.sln and the CLI project, with hello-brick as the smallest test
example, and the compatibility matrix names the solutions that actually
apply.
spikes/README.md: the 27 tracked files under spikes/ were cited as PASS
evidence by the ledger but undocumented. It says what each spike is, every
flag of the flight runner, which ledger rows cite each spike, and that none
of it is a supported entry point.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@IanFrelingerIanFrelinger mentioned this pull request Aug 17, 2026
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@IanFrelinger@cursoragent