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/phase-go-live.html ADDED Viewed

@@ -0,0 +1,103 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Go Live | 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">
+          <p class="section-kicker">Phase 05</p>
+          <h1>Go Live</h1>
+          <p class="lede">
+            Go Live prepares a specific change, confirms readiness, records the plan, and puts it into use.
+          </p>
+          <p>
+            Read the workflow from top to bottom. Each column shows the role leading that step.
+          </p>
+          <div class="lane-workflow lane-workflow--five" aria-label="Go Live phase workflow">
+            <div class="lane-head">Engineer</div>
+            <div class="lane-head">Tester</div>
+            <div class="lane-head">Operator</div>
+            <div class="lane-head">Owner</div>
+            <div class="lane-head">Support Agent</div>
+            <div class="lane-cell"><div class="work-step">Prepares the release and change details.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Confirms readiness checks are complete.</div></div>
+            <div class="lane-cell"><div class="work-step">Records the change plan, execution steps, and rollback path.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Prepares user help and known issue notes.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step work-step--choice">Ready to proceed?</div></div>
+            <div class="lane-cell"><div class="work-step">Accepts open risk when formal ownership is needed.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Puts the change into use and records the result.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Supports users after the change is live.</div></div>
+          </div>
+        </section>
+        <section class="doc-section doc-section--last">
+          <div class="phase-summary">
+            <section>
+              <h2>Records</h2>
+              <ul>
+                <li>Change</li>
+                <li>Task</li>
+                <li>Decision</li>
+                <li>Risk</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Important choices</h2>
+              <ul>
+                <li>Are readiness checks complete?</li>
+                <li>Has notice been given, and is any veto recorded?</li>
+                <li>If this is an emergency, are both importance and immediacy clear?</li>
+                <li>Is any open risk visible or formally accepted by the Owner?</li>
+                <li>Should the change proceed, be deferred, be cancelled, or need recovery?</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Handoff</h2>
+              <p>Go Live ends when the change history shows what was decided, what happened, and whether recovery was needed.</p>
+            </section>
+          </div>
+          <div class="phase-nav">
+            <a href="./phase-build.html">Previous: Build</a>
+            <a href="./flow.html">All phases</a>
+            <a href="./phase-operate.html">Next: Operate</a>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/phase-measure.html ADDED Viewed

@@ -0,0 +1,93 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Measure | 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">
+          <p class="section-kicker">Phase 07</p>
+          <h1>Measure</h1>
+          <p class="lede">
+            Measure compares expected and actual cost or benefit when useful data is available.
+          </p>
+          <p>
+            Read the workflow from top to bottom. Each column shows the role leading that step.
+          </p>
+          <div class="lane-workflow lane-workflow--three" aria-label="Measure phase workflow">
+            <div class="lane-head">Operator</div>
+            <div class="lane-head">Owner</div>
+            <div class="lane-head">Engineer</div>
+            <div class="lane-cell"><div class="work-step">Gathers actual run cost and service data when available.</div></div>
+            <div class="lane-cell"><div class="work-step">Gathers benefit signals and user outcomes.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step work-step--choice">Is useful measurement data available?</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Compares delivery results with the original estimate.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Compares actual results with expected value and reviews whether the outcome justifies more investment.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Improves run assumptions for future work.</div></div>
+            <div class="lane-cell"><div class="work-step">Improves value assumptions for future work.</div></div>
+            <div class="lane-cell"><div class="work-step">Improves delivery assumptions for future work.</div></div>
+          </div>
+        </section>
+        <section class="doc-section doc-section--last">
+          <div class="phase-summary">
+            <section>
+              <h2>Records</h2>
+              <ul>
+                <li>Estimate</li>
+                <li>Benefits</li>
+                <li>Decision</li>
+                <li>Risk</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Important choices</h2>
+              <ul>
+                <li>Is useful measurement data available?</li>
+                <li>Did the work create enough value?</li>
+                <li>Which assumptions should change for future work?</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Handoff</h2>
+              <p>Measure ends with better assumptions and, when needed, a new improvement request.</p>
+            </section>
+          </div>
+          <div class="phase-nav">
+            <a href="./phase-operate.html">Previous: Operate</a>
+            <a href="./flow.html">All phases</a>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/phase-operate.html ADDED Viewed

@@ -0,0 +1,102 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Operate | 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">
+          <p class="section-kicker">Phase 06</p>
+          <h1>Operate</h1>
+          <p class="lede">
+            Operate keeps the service running, helps users, and responds when something goes wrong.
+          </p>
+          <p>
+            Read the workflow from top to bottom. Each column shows the role leading that step.
+          </p>
+          <div class="lane-workflow lane-workflow--four" aria-label="Operate phase workflow">
+            <div class="lane-head">End User</div>
+            <div class="lane-head">Support Agent</div>
+            <div class="lane-head">Operator</div>
+            <div class="lane-head">Owner</div>
+            <div class="lane-cell"><div class="work-step">Uses the service and reports questions, requests, or issues.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Triages the request and helps the user when possible.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step work-step--choice">User help or service issue?</div></div>
+            <div class="lane-cell"><div class="work-step">Responds to incidents and restores service.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Closes resolved requests or escalates repeated issues.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Reviews repeated signals and improvement ideas.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Keeps the service stable or records a change when the service must be altered.</div></div>
+            <div class="lane-cell"><div class="work-step">Moves improvement ideas back into Orient when needed.</div></div>
+          </div>
+        </section>
+        <section class="doc-section doc-section--last">
+          <div class="phase-summary">
+            <section>
+              <h2>Records</h2>
+              <ul>
+                <li>Change</li>
+                <li>DX Complete Ticket</li>
+                <li>Risk</li>
+                <li>Decision</li>
+                <li>Task</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Important choices</h2>
+              <ul>
+                <li>Is this user help, a service issue, or both?</li>
+                <li>Does the issue need urgent response?</li>
+                <li>Does the running service need a recorded change?</li>
+                <li>Is there a repeated problem that should become improvement work?</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Handoff</h2>
+              <p>Operate continues while the service is live. Issues can close, escalate, or become new improvement work.</p>
+            </section>
+          </div>
+          <div class="phase-nav">
+            <a href="./phase-go-live.html">Previous: Go Live</a>
+            <a href="./flow.html">All phases</a>
+            <a href="./phase-measure.html">Next: Measure</a>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/phase-orient.html ADDED Viewed

@@ -0,0 +1,92 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Orient | 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">
+          <p class="section-kicker">Phase 01</p>
+          <h1>Orient</h1>
+          <p class="lede">
+            Orient captures the desired outcome in plain terms, restates expectations, and confirms how success will be recognized where possible.
+          </p>
+          <p>
+            This phase understands the result people need before translating it into requirements. Read the workflow from top to bottom. Each column shows the role leading that step.
+          </p>
+          <div class="lane-workflow lane-workflow--two" aria-label="Orient phase workflow">
+            <div class="lane-head">End User</div>
+            <div class="lane-head">Owner</div>
+            <div class="lane-cell"><div class="work-step">Shares the goal, problem, request, concern, or opportunity in their own words.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Captures the statement, asks clarifying questions, restates expectations, and confirms the wording before recording it.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Approves expectations when authority approval is needed.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Confirms priority, spending authority, and the decision path.</div></div>
+            <div class="lane-cell"><div class="work-step">Adds missing context when needed.</div></div>
+            <div class="lane-cell"><div class="work-step work-step--choice">Clear enough to translate into requirements?</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Decides whether to continue, pause, stop, or formally accept the open risk.</div></div>
+          </div>
+        </section>
+        <section class="doc-section doc-section--last">
+          <div class="phase-summary">
+            <section>
+              <h2>Records</h2>
+              <ul>
+                <li>Workspace</li>
+                <li>Statement</li>
+                <li>Expectation</li>
+                <li>DX Complete Ticket</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Important choices</h2>
+              <ul>
+                <li>Has the original statement been captured in the person's own words?</li>
+                <li>Was captured wording confirmed before it was recorded?</li>
+                <li>Are expectations approved, not approved yet, or moving forward with open risk visible?</li>
+                <li>Do expectations describe how success will be recognized?</li>
+                <li>Is the right decision authority involved?</li>
+                <li>Should the request continue, pause, stop, or continue with open risk visible?</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Handoff</h2>
+              <p>Orient ends with expectations that are clear enough to use, with approval where needed or visible risk where approval is missing.</p>
+            </section>
+          </div>
+          <div class="phase-nav">
+            <a href="./flow.html">All phases</a>
+            <a href="./phase-elicit.html">Next: Elicit</a>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/phase-weigh.html ADDED Viewed

@@ -0,0 +1,98 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Weigh | 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">
+          <p class="section-kicker">Phase 03</p>
+          <h1>Weigh</h1>
+          <p class="lede">
+            Weigh compares expected cost, expected benefit, risk, and confidence before recording a Commitment or Deferral.
+          </p>
+          <p>
+            Read the workflow from top to bottom. Each column shows the role leading that step.
+          </p>
+          <div class="lane-workflow lane-workflow--three" aria-label="Weigh phase workflow">
+            <div class="lane-head">Owner</div>
+            <div class="lane-head">Engineer</div>
+            <div class="lane-head">Operator</div>
+            <div class="lane-cell"><div class="work-step">Summarizes the requirement set, expected benefits, and scope.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Prepares the cost estimate, dependencies, delivery risk, and important review notes.</div></div>
+            <div class="lane-cell"><div class="work-step">Estimates run cost, support needs, and readiness work.</div></div>
+            <div class="lane-cell"><div class="work-step">Weighs expected benefits against cost, risk, and confidence.</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step work-step--choice">Commit or defer?</div></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"></div>
+            <div class="lane-cell"><div class="work-step">Records a Commitment or Deferral.</div></div>
+            <div class="lane-cell"><div class="work-step">Prepares requirement detail and task planning.</div></div>
+            <div class="lane-cell"></div>
+          </div>
+        </section>
+        <section class="doc-section doc-section--last">
+          <div class="phase-summary">
+            <section>
+              <h2>Records</h2>
+              <ul>
+                <li>Estimate</li>
+                <li>Benefits</li>
+                <li>Requirement</li>
+                <li>Commitment</li>
+                <li>Deferral</li>
+                <li>Risk</li>
+                <li>Decision</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Important choices</h2>
+              <ul>
+                <li>Are expected cost and expected benefit clear enough?</li>
+                <li>Are important review notes visible?</li>
+                <li>Is any open risk visible or formally accepted by the Owner?</li>
+                <li>Is the Owner committing now or deferring until named conditions are addressed?</li>
+              </ul>
+            </section>
+            <section>
+              <h2>Handoff</h2>
+              <p>Weigh ends with a Commitment that can move into Build, or a Deferral that shows what must be addressed first.</p>
+            </section>
+          </div>
+          <div class="phase-nav">
+            <a href="./phase-elicit.html">Previous: Elicit</a>
+            <a href="./flow.html">All phases</a>
+            <a href="./phase-build.html">Next: Build</a>
+          </div>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/roles.html ADDED Viewed

@@ -0,0 +1,52 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Roles | 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">Operating model</p>
+          <h1>Roles</h1>
+          <p class="lede">
+            Roles separate responsibility so decisions, building, quality checks, support, and service operation are not confused.
+          </p>
+          <div class="role-list">
+            <button type="button" data-detail="owner">Owner</button>
+            <button type="button" data-detail="engineer">Engineer</button>
+            <button type="button" data-detail="tester">Tester</button>
+            <button type="button" data-detail="operator">Operator</button>
+            <button type="button" data-detail="supportAgent">Support Agent</button>
+            <button type="button" data-detail="endUser">End User</button>
+          </div>
+          <p id="role-detail" class="detail-panel" aria-live="polite">
+            Owner sets authority, priority, outcome direction, requirements, product validation direction, budget commitment, escalation direction, and formal risk acceptance. Engineer turns committed requirements into tasks and working changes.
+          </p>
+        </section>
+      </main>
+    </div>
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>