npm - dxcomplete - Versions diffs - 0.1.0 - Mend

dxcomplete 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (121) hide show

package/.env.example +11 -0
package/README.md +215 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.js +212 -0
package/dist/http/server.d.ts +7 -0
package/dist/http/server.js +236 -0
package/dist/http/service.d.ts +7 -0
package/dist/http/service.js +725 -0
package/dist/init.d.ts +13 -0
package/dist/init.js +128 -0
package/dist/install-manifest.d.ts +25 -0
package/dist/install-manifest.js +96 -0
package/dist/mcp/docs.d.ts +98 -0
package/dist/mcp/docs.js +438 -0
package/dist/mcp/server.d.ts +20 -0
package/dist/mcp/server.js +2345 -0
package/dist/package-root.d.ts +2 -0
package/dist/package-root.js +28 -0
package/dist/runtime/actor.d.ts +14 -0
package/dist/runtime/actor.js +42 -0
package/dist/runtime/auth.d.ts +162 -0
package/dist/runtime/auth.js +394 -0
package/dist/runtime/check.d.ts +7 -0
package/dist/runtime/check.js +16 -0
package/dist/runtime/config.d.ts +17 -0
package/dist/runtime/config.js +93 -0
package/dist/runtime/mongo.d.ts +9 -0
package/dist/runtime/mongo.js +56 -0
package/dist/runtime/records.d.ts +336 -0
package/dist/runtime/records.js +1463 -0
package/dist/runtime/workspace.d.ts +19 -0
package/dist/runtime/workspace.js +102 -0
package/dist/upgrade.d.ts +20 -0
package/dist/upgrade.js +246 -0
package/dist/validate.d.ts +10 -0
package/dist/validate.js +119 -0
package/dist/version.d.ts +3 -0
package/dist/version.js +12 -0
package/docs/codex-integration.md +29 -0
package/docs/cost-model.md +61 -0
package/docs/decision-basis.md +57 -0
package/docs/diagrams.md +31 -0
package/docs/glossary.md +147 -0
package/docs/index.md +60 -0
package/docs/model.md +110 -0
package/docs/open-questions.md +61 -0
package/docs/roles.md +42 -0
package/docs/taxonomy.md +96 -0
package/docs/workflows.md +60 -0
package/package.json +62 -0
package/scripts/check-env-surface.mjs +136 -0
package/scripts/check-public-copy.mjs +263 -0
package/scripts/check-service-boundary.mjs +63 -0
package/scripts/dogfood-work-order.mjs +506 -0
package/scripts/smoke-mcp-http.mjs +3572 -0
package/src/cli.ts +268 -0
package/src/http/server.ts +314 -0
package/src/http/service.ts +934 -0
package/src/init.ts +227 -0
package/src/install-manifest.ts +144 -0
package/src/mcp/docs.ts +557 -0
package/src/mcp/server.ts +3525 -0
package/src/package-root.ts +31 -0
package/src/runtime/actor.ts +61 -0
package/src/runtime/auth.ts +673 -0
package/src/runtime/check.ts +18 -0
package/src/runtime/config.ts +128 -0
package/src/runtime/mongo.ts +89 -0
package/src/runtime/records.ts +2303 -0
package/src/runtime/workspace.ts +155 -0
package/src/upgrade.ts +356 -0
package/src/validate.ts +139 -0
package/src/version.ts +16 -0
package/templates/github/workflows/dxcomplete.yml +16 -0
package/templates/next/pages/api/auth/callback/google.js +12 -0
package/templates/next/pages/api/dxcomplete/[...path].js +12 -0
package/templates/next/pages/api/dxcomplete.js +12 -0
package/templates/next/pages/api/mcp.js +12 -0
package/templates/next/vercel.json +18 -0
package/templates/process/README.md +38 -0
package/templates/process/controls.yml +113 -0
package/templates/process/cost-model.yml +71 -0
package/templates/process/decision-basis.yml +53 -0
package/templates/process/decisions/.gitkeep +1 -0
package/templates/process/diagrams/00-decision-basis.mmd +24 -0
package/templates/process/diagrams/00-overview.mmd +20 -0
package/templates/process/diagrams/01-intake-triage.mmd +20 -0
package/templates/process/diagrams/02-product-definition.mmd +14 -0
package/templates/process/diagrams/03-engineering-execution.mmd +15 -0
package/templates/process/diagrams/04-qa-verification.mmd +12 -0
package/templates/process/diagrams/05-product-validation.mmd +12 -0
package/templates/process/diagrams/06-change-release-control.mmd +16 -0
package/templates/process/diagrams/07-deployment-operations.mmd +16 -0
package/templates/process/diagrams/08-support-incident-management.mmd +16 -0
package/templates/process/diagrams/09-problem-improvement.mmd +14 -0
package/templates/process/diagrams/10-risk-control-management.mmd +14 -0
package/templates/process/diagrams/11-audit-evidence-capture.mmd +13 -0
package/templates/process/evidence/.gitkeep +1 -0
package/templates/process/risks/.gitkeep +1 -0
package/templates/process/roles.yml +96 -0
package/templates/process/taxonomy.yml +514 -0
package/templates/process/workflows.yml +210 -0
package/website/.well-known/oauth-authorization-server +22 -0
package/website/.well-known/oauth-protected-resource/api/dxcomplete/mcp +10 -0
package/website/.well-known/oauth-protected-resource/api/mcp +10 -0
package/website/README.md +12 -0
package/website/app.js +36 -0
package/website/flow.html +85 -0
package/website/glossary.html +280 -0
package/website/index.html +90 -0
package/website/objects.html +287 -0
package/website/outcomes.html +117 -0
package/website/phase-build.html +101 -0
package/website/phase-elicit.html +102 -0
package/website/phase-go-live.html +103 -0
package/website/phase-measure.html +93 -0
package/website/phase-operate.html +102 -0
package/website/phase-orient.html +92 -0
package/website/phase-weigh.html +98 -0
package/website/roles.html +52 -0
package/website/styles.css +1169 -0

package/website/glossary.html ADDED Viewed

@@ -0,0 +1,280 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Glossary | DX Complete</title>
+    <link rel="stylesheet" href="./styles.css?v=5" />
+  </head>
+  <body>
+    <a class="skip-link" href="#content">Skip to content</a>
+    <header class="topbar">
+      <div class="topbar__brand">
+        <span class="brand-mark" aria-hidden="true">DX</span>
+        <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
+      </div>
+    </header>
+    <div class="layout">
+      <aside class="sidebar" aria-label="Documentation pages">
+        <div class="sidebar__eyebrow">Pages</div>
+        <nav>
+          <a class="nav-link" href="./index.html">Start here</a>
+          <a class="nav-link" href="./outcomes.html">Outcomes</a>
+          <a class="nav-link" href="./flow.html">Flow</a>
+          <a class="nav-link" href="./objects.html">Records</a>
+          <a class="nav-link" href="./roles.html">Roles</a>
+          <a class="nav-link" href="./glossary.html">Glossary</a>
+        </nav>
+      </aside>
+      <main id="content" class="content" tabindex="-1">
+        <section class="doc-section doc-section--last">
+          <p class="section-kicker">Reference</p>
+          <h1>Glossary</h1>
+          <p class="lede">
+            Common DX Complete terms, written in plain language.
+          </p>
+          <nav class="az-index" aria-label="Glossary A-Z index">
+            <a href="#a">A</a>
+            <a href="#b">B</a>
+            <a href="#c">C</a>
+            <a href="#d">D</a>
+            <a href="#e">E</a>
+            <a href="#f">F</a>
+            <a href="#g">G</a>
+            <a href="#h">H</a>
+            <a href="#i">I</a>
+            <a href="#j">J</a>
+            <span aria-disabled="true">K</span>
+            <a href="#l">L</a>
+            <a href="#m">M</a>
+            <span aria-disabled="true">N</span>
+            <a href="#o">O</a>
+            <a href="#p">P</a>
+            <a href="#q">Q</a>
+            <a href="#r">R</a>
+            <a href="#s">S</a>
+            <a href="#t">T</a>
+            <a href="#u">U</a>
+            <a href="#v">V</a>
+            <a href="#w">W</a>
+            <span aria-disabled="true">X</span>
+            <span aria-disabled="true">Y</span>
+            <span aria-disabled="true">Z</span>
+          </nav>
+          <div class="glossary-alpha" aria-label="Alphabetical glossary">
+            <section id="a" class="glossary-letter">
+              <h2>A</h2>
+              <dl class="glossary-list">
+                <div><dt>Approval <span>Risk and decisions</span></dt><dd>A separate authority confirming an expectation or decision, tracked when it reduces risk.</dd></div>
+              </dl>
+            </section>
+            <section id="b" class="glossary-letter">
+              <h2>B</h2>
+              <dl class="glossary-list">
+                <div><dt>Benefit Item <span>Cost and benefit</span></dt><dd>One item inside Benefits. It may have an amount or range, or it may be qualitative with no amount.</dd></div>
+                <div><dt>Benefits <span>Cost and benefit</span></dt><dd>The expected value used during Weigh. Benefits may be quantified or qualitative.</dd></div>
+                <div><dt>Build <span>Delivery</span></dt><dd>Turning committed requirements into tasks, working changes, and verification.</dd></div>
+              </dl>
+            </section>
+            <section id="c" class="glossary-letter">
+              <h2>C</h2>
+              <dl class="glossary-list">
+                <div><dt>Change <span>Delivery</span></dt><dd>A record for a specific alteration to the running service. It keeps the plan, execution, rollback, notice, veto, emergency, decision, result, and recovery history without controlling the operation.</dd></div>
+                <div><dt>Change Plan <span>Delivery</span></dt><dd>The part of a Change record that explains what is changing, why, scope, timing, and notice.</dd></div>
+                <div><dt>Checkpoint <span>Risk and decisions</span></dt><dd>A confirmation point that reduces risk. It can be approved, formally accepted as risk by the Owner, or proceeded past with open risk visible.</dd></div>
+                <div><dt>Codex <span>Delivery</span></dt><dd>A coding-capable model that may assist the Engineer. Codex is not a role.</dd></div>
+                <div><dt>Commitment <span>Business context</span></dt><dd>An Owner record that says preparation is sufficient to commit requirements or expectations into Build, with any reservations kept visible.</dd></div>
+                <div><dt>Complete Engineering <span>Delivery</span></dt><dd>The delivery part of DX Complete: build, check, validate, and put the change into use.</dd></div>
+                <div><dt>Component <span>Run and support</span></dt><dd>One operational item in one Environment, such as an app, database, queue, storage location, or external service.</dd></div>
+                <div><dt>Condition <span>Business context</span></dt><dd>Something that must be addressed before a Deferral can resolve into a Commitment.</dd></div>
+                <div><dt>Constraints <span>Business context</span></dt><dd>Limits that affect the work, such as time, access, policy, budget, or risk.</dd></div>
+                <div><dt>Control <span>Risk and decisions</span></dt><dd>A rule, check, or approval used to reduce risk.</dd></div>
+              </dl>
+            </section>
+            <section id="d" class="glossary-letter">
+              <h2>D</h2>
+              <dl class="glossary-list">
+                <div><dt>Decision <span>Risk and decisions</span></dt><dd>A recorded choice with entries kept in order. The latest decision entry is the current decision, while earlier entries remain visible.</dd></div>
+                <div><dt>Decision Entry <span>Risk and decisions</span></dt><dd>One entry in a decision, such as an argument, note, or choice.</dd></div>
+                <div><dt>Decision Input <span>Risk and decisions</span></dt><dd>A record that informed a decision. A decision can show what informed it, and a record can show which decisions used it.</dd></div>
+                <div><dt>Deferral <span>Business context</span></dt><dd>An Owner record for not committing yet, with explicit conditions that make the path to a future Commitment clear.</dd></div>
+                <div><dt>Dependencies <span>Business context</span></dt><dd>People, systems, data, or decisions the work depends on.</dd></div>
+                <div><dt>Deployment <span>Delivery</span></dt><dd>Putting a release or change into use.</dd></div>
+                <div><dt>DX Complete Ticket <span>Business context</span></dt><dd>A private item used to raise a question, report, request, correction, or follow-up with DX Complete.</dd></div>
+              </dl>
+            </section>
+            <section id="e" class="glossary-letter">
+              <h2>E</h2>
+              <dl class="glossary-list">
+                <div><dt>Elicit <span>Business context</span></dt><dd>Turning expectations into requirements, dependencies, unknowns, and risk before estimating the work.</dd></div>
+                <div><dt>Emergency Change <span>Delivery</span></dt><dd>A change where normal notice is shortened or skipped because both importance and immediacy are recorded.</dd></div>
+                <div><dt>End User <span>Role</span></dt><dd>The person the service is for; uses the service and provides requests, feedback, corrections, and issue reports.</dd></div>
+                <div><dt>Engineer <span>Role</span></dt><dd>The role that turns committed requirements into tasks and working changes, directly or by driving coding-capable tools.</dd></div>
+                <div><dt>Environment <span>Run and support</span></dt><dd>A named operating context such as local, staging, or production. Components belong to one Environment so each context can be understood separately.</dd></div>
+                <div><dt>Estimate <span>Cost and benefit</span></dt><dd>An itemized cost estimate used during Weigh, linked to the requirements or expectations it covers.</dd></div>
+                <div><dt>Estimate Line Item <span>Cost and benefit</span></dt><dd>One cost item inside an Estimate, with a label, amount or range, one-time or recurring timing, and currency.</dd></div>
+                <div><dt>Estimate Refinement <span>Cost and benefit</span></dt><dd>Using real results to improve future cost and benefit estimates.</dd></div>
+                <div><dt>Evidence <span>Risk and decisions</span></dt><dd>Information that supports a decision, check, release, or measurement.</dd></div>
+                <div><dt>Execution Plan <span>Delivery</span></dt><dd>The ordered practical steps inside a Change record for carrying out the change.</dd></div>
+                <div><dt>Expectation <span>Business context</span></dt><dd>The result a person or group expects, including how success will be recognized, with approval tracked where needed.</dd></div>
+              </dl>
+            </section>
+            <section id="f" class="glossary-letter">
+              <h2>F</h2>
+              <dl class="glossary-list">
+                <div><dt>Feedback <span>Run and support</span></dt><dd>A signal from a user, support interaction, service issue, or observed result.</dd></div>
+              </dl>
+            </section>
+            <section id="g" class="glossary-letter">
+              <h2>G</h2>
+              <dl class="glossary-list">
+                <div><dt>Go Live <span>Delivery</span></dt><dd>Putting a change into use after readiness is confirmed.</dd></div>
+                <div><dt>Greenfield <span>Business context</span></dt><dd>Work that starts from a new idea rather than an existing service.</dd></div>
+              </dl>
+            </section>
+            <section id="h" class="glossary-letter">
+              <h2>H</h2>
+              <dl class="glossary-list">
+                <div><dt>Handoff <span>Delivery</span></dt><dd>The point where a phase has enough clarity to move into the next phase.</dd></div>
+              </dl>
+            </section>
+            <section id="i" class="glossary-letter">
+              <h2>I</h2>
+              <dl class="glossary-list">
+                <div><dt>Incident <span>Run and support</span></dt><dd>An event that affects, or may affect, the service and needs a response.</dd></div>
+                <div><dt>Informed By <span>Risk and decisions</span></dt><dd>The relationship from a decision to the record that helped inform it.</dd></div>
+              </dl>
+            </section>
+            <section id="j" class="glossary-letter">
+              <h2>J</h2>
+              <dl class="glossary-list">
+                <div><dt>Journal <span>Business context</span></dt><dd>A shared workspace record for useful notes that do not have a better dedicated home.</dd></div>
+                <div><dt>Journal Note <span>Business context</span></dt><dd>A raw Journal entry with text, author, and time. It can be summarized later without being deleted.</dd></div>
+                <div><dt>Journal Summary <span>Business context</span></dt><dd>A compact Journal entry that summarizes older notes and points back to them so details remain retrievable.</dd></div>
+              </dl>
+            </section>
+            <section id="l" class="glossary-letter">
+              <h2>L</h2>
+              <dl class="glossary-list">
+                <div><dt>Limited Disclosure <span>Business context</span></dt><dd>A situation where some information is unavailable or cannot be shared.</dd></div>
+                <div><dt>Locator <span>Run and support</span></dt><dd>Location information for a Component, such as a URL, project, region, host, or route.</dd></div>
+              </dl>
+            </section>
+            <section id="m" class="glossary-letter">
+              <h2>M</h2>
+              <dl class="glossary-list">
+                <div><dt>Measure <span>Cost and benefit</span></dt><dd>Compare expected and actual cost or benefit when data is available.</dd></div>
+                <div><dt>Measurement <span>Cost and benefit</span></dt><dd>Comparing expected and actual cost or benefit when data is available.</dd></div>
+              </dl>
+            </section>
+            <section id="o" class="glossary-letter">
+              <h2>O</h2>
+              <dl class="glossary-list">
+                <div><dt>Operate <span>Run and support</span></dt><dd>Run the service, support users, and respond to issues.</dd></div>
+                <div><dt>Operational Registry <span>Run and support</span></dt><dd>The inventory of Environments and Components. It shows what exists and where it lives without monitoring, diagnosing, storing secret values, or replacing operating procedures.</dd></div>
+                <div><dt>Operator <span>Role</span></dt><dd>The role that releases, deploys, monitors, runs the service, and manages users, permissions, settings, provisioning, and run-side security.</dd></div>
+                <div><dt>Outcome <span>Business context</span></dt><dd>The result the work is meant to create or improve.</dd></div>
+                <div><dt>Owner <span>Role</span></dt><dd>The role that sets authority, priority, outcome direction, requirements, product validation direction, budget commitment, escalation direction, and formal risk acceptance.</dd></div>
+              </dl>
+            </section>
+            <section id="p" class="glossary-letter">
+              <h2>P</h2>
+              <dl class="glossary-list">
+                <div><dt>Problem <span>Run and support</span></dt><dd>An underlying or repeated issue that may need deeper improvement work.</dd></div>
+                <div><dt>Proceeding Past an Open Checkpoint <span>Risk and decisions</span></dt><dd>Moving forward while an approval, readiness concern, or other checkpoint is still open. The risk remains visible and is not formally accepted.</dd></div>
+                <div><dt>Product Validation <span>Delivery</span></dt><dd>Confirming that the completed work achieves the intended outcome.</dd></div>
+              </dl>
+            </section>
+            <section id="q" class="glossary-letter">
+              <h2>Q</h2>
+              <dl class="glossary-list">
+                <div><dt>QA Verification <span>Delivery</span></dt><dd>Checking that completed work meets the requirements and success criteria.</dd></div>
+              </dl>
+            </section>
+            <section id="r" class="glossary-letter">
+              <h2>R</h2>
+              <dl class="glossary-list">
+                <div><dt>Readable ID <span>Business context</span></dt><dd>A short record reference such as REQ-0001. It helps people refer to a record without reading the full system ID.</dd></div>
+                <div><dt>Readiness Checks <span>Delivery</span></dt><dd>The checks used before Go Live to confirm that a change is prepared, supportable, and safe enough to put into use.</dd></div>
+                <div><dt>Record <span>Business context</span></dt><dd>Information kept so decisions, work, service issues, and measurements can be followed over time.</dd></div>
+                <div><dt>Record Link <span>Business context</span></dt><dd>A relationship from one record to another. Links can be added or removed when the relationship changes or was recorded incorrectly.</dd></div>
+                <div><dt>Release <span>Delivery</span></dt><dd>A set of changes prepared to be put into use.</dd></div>
+                <div><dt>Requirement <span>Delivery</span></dt><dd>A commitment to make something true in a buildable and checkable way.</dd></div>
+                <div><dt>Requirement Detail <span>Delivery</span></dt><dd>Optional behavior, edge cases, or check notes kept with a requirement.</dd></div>
+                <div><dt>Requirement Set <span>Business context</span></dt><dd>The group of requirements being estimated, committed, built, or stopped together.</dd></div>
+                <div><dt>Reservation <span>Business context</span></dt><dd>A concern recorded inside a Commitment when the Owner moves forward despite it.</dd></div>
+                <div><dt>Review Note <span>Delivery</span></dt><dd>A free-text note on an expectation or requirement. It may be marked important, but it does not block progress or require an Owner response.</dd></div>
+                <div><dt>Risk <span>Risk and decisions</span></dt><dd>Something uncertain that could affect value, delivery, service, or compliance.</dd></div>
+                <div><dt>Risk Acceptance <span>Risk and decisions</span></dt><dd>An Owner decision to own an open risk on the project's behalf. It is different from simply proceeding past an open checkpoint.</dd></div>
+                <div><dt>Roll-up <span>Cost and benefit</span></dt><dd>Grouped totals from quantified cost or benefit items, keeping one-time amounts, recurring amounts, periods, and currencies distinct.</dd></div>
+                <div><dt>Rollback Plan <span>Delivery</span></dt><dd>The part of a Change record that explains how to reverse or recover if the change fails or should not remain in use.</dd></div>
+              </dl>
+            </section>
+            <section id="s" class="glossary-letter">
+              <h2>S</h2>
+              <dl class="glossary-list">
+                <div><dt>Secret Pointer <span>Run and support</span></dt><dd>A reference to where a secret is stored and what it is called. It should not contain the secret value.</dd></div>
+                <div><dt>Statement <span>Business context</span></dt><dd>A person's own words before they are interpreted or translated.</dd></div>
+                <div><dt>Success Criteria <span>Delivery</span></dt><dd>The conditions used to decide whether completed work satisfies the need.</dd></div>
+                <div><dt>Support Agent <span>Role</span></dt><dd>The role that helps users, captures signals, and routes questions, feedback, and issues to the right follow-up.</dd></div>
+                <div><dt>Support Ticket <span>Run and support</span></dt><dd>A user request, question, or issue report.</dd></div>
+              </dl>
+            </section>
+            <section id="t" class="glossary-letter">
+              <h2>T</h2>
+              <dl class="glossary-list">
+                <div><dt>Task <span>Delivery</span></dt><dd>A piece of work with entries kept in order. The latest status entry is the current task status.</dd></div>
+                <div><dt>Task Entry <span>Delivery</span></dt><dd>One entry in a task, such as a comment, note, or status change.</dd></div>
+                <div><dt>Tester <span>Role</span></dt><dd>The role that checks completed work against requirements and success criteria.</dd></div>
+                <div><dt>Transformation <span>Business context</span></dt><dd>Improving an existing service or way of working.</dd></div>
+              </dl>
+            </section>
+            <section id="u" class="glossary-letter">
+              <h2>U</h2>
+              <dl class="glossary-list">
+                <div><dt>Unknowns <span>Business context</span></dt><dd>Important questions that are not answered yet.</dd></div>
+              </dl>
+            </section>
+            <section id="v" class="glossary-letter">
+              <h2>V</h2>
+              <dl class="glossary-list">
+                <div><dt>Version History <span>Risk and decisions</span></dt><dd>Prior versions kept when an expectation or requirement changes, so current wording can be understood without losing what came before.</dd></div>
+                <div><dt>Veto <span>Risk and decisions</span></dt><dd>A serious recorded objection to a Change by the Owner or Engineer. It does not mechanically stop the Operator, but proceeding over it creates a strong accountability record.</dd></div>
+              </dl>
+            </section>
+            <section id="w" class="glossary-letter">
+              <h2>W</h2>
+              <dl class="glossary-list">
+                <div><dt>Weigh <span>Business context</span></dt><dd>The phase where cost, value, risk, and confidence are compared before recording a Commitment or Deferral.</dd></div>
+                <div><dt>Workspace <span>Business context</span></dt><dd>The container for one service and the work connected to it.</dd></div>
+              </dl>
+            </section>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/index.html ADDED Viewed

@@ -0,0 +1,90 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>DX Complete Documentation</title>
+    <link rel="stylesheet" href="./styles.css?v=5" />
+  </head>
+  <body>
+    <a class="skip-link" href="#content">Skip to content</a>
+    <header class="topbar">
+      <div class="topbar__brand">
+        <span class="brand-mark" aria-hidden="true">DX</span>
+        <span>
+          <strong>DX Complete</strong>
+          <small>Plan, deliver, run, measure</small>
+        </span>
+      </div>
+    </header>
+    <div class="layout">
+      <aside class="sidebar" aria-label="Documentation pages">
+        <div class="sidebar__eyebrow">Pages</div>
+        <nav>
+          <a class="nav-link" href="./index.html">Start here</a>
+          <a class="nav-link" href="./outcomes.html">Outcomes</a>
+          <a class="nav-link" href="./flow.html">Flow</a>
+          <a class="nav-link" href="./objects.html">Records</a>
+          <a class="nav-link" href="./roles.html">Roles</a>
+          <a class="nav-link" href="./glossary.html">Glossary</a>
+        </nav>
+      </aside>
+      <main id="content" class="content" tabindex="-1">
+        <section class="doc-section doc-section--last">
+          <p class="section-kicker">Start here</p>
+          <h1>DX Complete</h1>
+          <p class="lede">
+            A practical way to decide what is worth doing, deliver it with control, run it safely, and learn from the results.
+          </p>
+          <p>
+            The documentation is split into outcomes, flow, records, roles, and terms. Outcomes explain why the process exists. Flow explains what happens over time. Records explain what gets captured. Roles explain who is responsible. The glossary defines shared language.
+          </p>
+          <div class="phase-map" aria-label="DX Complete broad phases">
+            <div>
+              <span>01</span>
+              <strong>Orient</strong>
+              <p>Capture the desired outcome, restate expectations, and confirm how success will be recognized.</p>
+            </div>
+            <div>
+              <span>02</span>
+              <strong>Elicit</strong>
+              <p>Turn expectations into requirements, dependencies, unknowns, and risk.</p>
+            </div>
+            <div>
+              <span>03</span>
+              <strong>Weigh</strong>
+              <p>Compare expected cost, expected value, risks, and confidence before recording a Commitment or Deferral.</p>
+            </div>
+            <div>
+              <span>04</span>
+              <strong>Build</strong>
+              <p>Turn committed requirements into tasks and working changes.</p>
+            </div>
+            <div>
+              <span>05</span>
+              <strong>Go Live</strong>
+              <p>Prepare the change, confirm readiness, and put it into use.</p>
+            </div>
+            <div>
+              <span>06</span>
+              <strong>Operate</strong>
+              <p>Run the service, help users, and respond when something goes wrong.</p>
+            </div>
+            <div>
+              <span>07</span>
+              <strong>Measure</strong>
+              <p>Compare expected and actual cost or benefit when data is available.</p>
+            </div>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>