dxcomplete 0.2.2 → 0.3.0

package/templates/process/workflows.yml

@@ -1,19 +1,19 @@
 schema: dxcomplete.workflows.v0
-status: draft
+status: current
 notes:
   - These workflows are editable templates.
-  - Add, remove, merge, or split workflows as the model becomes clearer.
+  - Add, remove, merge, or split workflows when the workspace process changes.
 
 workflows:
   - id: decision_basis
     name: Decision basis
-    draft_purpose: Move from user statement to expectations and requirements with enough detail to support useful cost, benefit, risk, confidence, and Weigh outcomes.
+    purpose: Move from user statement to expectations and requirements with enough detail to support useful cost, benefit, risk, confidence, and Weigh outcomes.
     likely_roles:
       - Owner
       - Engineer
       - Operator
       - End User
-    draft_steps:
+    steps:
       - Capture statement in the user's own words and restate the expected result.
       - Confirm captured wording before recording it on the user's behalf.
       - Confirm how success will be recognized where possible.
@@ -39,12 +39,12 @@ workflows:
 
   - id: intake_triage
     name: Intake and triage
-    draft_purpose: Decide whether a signal should become a ticket, statement, requirement, task, risk, decision, change, journal note, or another matching lifecycle concept.
+    purpose: Decide whether a signal should become a ticket, statement, requirement, task, risk, decision, change, journal note, or another matching lifecycle concept.
     likely_roles:
       - Owner
       - Support Agent
       - Operator
-    draft_steps:
+    steps:
       - Capture signal.
       - Identify source and urgency.
       - Route to Owner, Operator, or Support Agent.
@@ -53,15 +53,15 @@ workflows:
 
   - id: product_definition
     name: Product definition
-    draft_purpose: Translate expectations into requirements before Weigh, then refine requirement detail after Commitment where needed.
+    purpose: Translate expectations into requirements before Weigh, then refine requirement detail after Commitment where needed.
     likely_roles:
       - Owner
       - End User
       - Engineer
-    draft_steps:
+    steps:
       - Review linked Statement, Estimate, Benefits, and decisions where available.
       - Review captured statement and expectations.
-      - Draft requirement and acceptance criteria.
+      - Prepare requirement and acceptance criteria.
       - Add Engineer review notes where delivery input should remain visible.
       - Refine requirement detail after Commitment where needed.
       - Link source objects.
@@ -70,10 +70,10 @@ workflows:
 
   - id: engineering_execution
     name: Engineering execution
-    draft_purpose: Refine committed requirements into tasks and perform implementation work.
+    purpose: Refine committed requirements into tasks and perform implementation work.
     likely_roles:
       - Engineer
-    draft_steps:
+    steps:
       - Review requirement and acceptance criteria.
       - Review important notes attached to expectations or requirements.
       - Add requirement detail and decide implementation approach.
@@ -83,11 +83,11 @@ workflows:
 
   - id: qa_verification
     name: QA verification
-    draft_purpose: Verify completed work against requirements and acceptance criteria.
+    purpose: Verify completed work against requirements and acceptance criteria.
     likely_roles:
       - Tester
       - Engineer
-    draft_steps:
+    steps:
       - Review requirement and task output.
       - Plan verification.
       - Execute checks.
@@ -96,11 +96,11 @@ workflows:
 
   - id: product_validation
     name: Product validation
-    draft_purpose: Decide whether verified work achieves the intended product outcome.
+    purpose: Decide whether verified work achieves the intended product outcome.
     likely_roles:
       - Owner
       - End User
-    draft_steps:
+    steps:
       - Review QA evidence.
       - Validate outcome against product intent.
       - Capture approval, rejection, or follow-up requirements.
@@ -108,13 +108,13 @@ workflows:
 
   - id: change_release_control
     name: Change and release control
-    draft_purpose: Record a discrete service change, including change type, plan, execution, rollback, notice, veto, and result.
+    purpose: Record a discrete service change, including change type, plan, execution, rollback, notice, veto, and result.
     likely_roles:
       - Operator
       - Owner
       - Engineer
       - Tester
-    draft_steps:
+    steps:
       - Record the Change baseline.
       - Confirm required evidence and notice.
       - Assess risk, impact, and rollback.
@@ -124,12 +124,12 @@ workflows:
 
   - id: deployment_operations
     name: Deployment and operations
-    draft_purpose: Deploy and run the service safely.
+    purpose: Deploy and run the service safely.
     likely_roles:
       - Operator
       - Engineer
       - Support Agent
-    draft_steps:
+    steps:
       - Prepare deployment.
       - Execute deployment.
       - Monitor service health.
@@ -139,11 +139,11 @@ workflows:
 
   - id: operational_registry
     name: Operational Registry maintenance
-    draft_purpose: Keep the inventory of Environments and Components understandable without turning it into monitoring, diagnostics, secret storage, event history, or a runbook.
+    purpose: Keep the inventory of Environments and Components understandable without turning it into monitoring, diagnostics, secret storage, event history, or a runbook.
     likely_roles:
       - Operator
       - Engineer
-    draft_steps:
+    steps:
       - Create or update Environment records for named operating contexts.
       - Create or update Component records for operational items in each Environment.
       - Record locator details, non-secret identifiers, and secret pointers where useful.
@@ -152,13 +152,13 @@ workflows:
 
   - id: support_incident_management
     name: Support and incident management
-    draft_purpose: Handle user-facing issues and service-impacting events, using Incident when a specific occurrence needs response history.
+    purpose: Handle user-facing issues and service-impacting events, using Incident when a specific occurrence needs response history.
     likely_roles:
       - Support Agent
       - Operator
       - Owner
       - Engineer
-    draft_steps:
+    steps:
       - Capture user or monitoring signal.
       - Classify as ticket, statement, incident, problem, risk, task, change, decision, requirement, or journal note.
       - Communicate status to affected users where needed.
@@ -167,13 +167,13 @@ workflows:
 
   - id: problem_improvement
     name: Problem and improvement management
-    draft_purpose: Convert recurring or root-cause signals into durable improvements through Problem records and linked follow-up.
+    purpose: Convert recurring or root-cause signals into durable improvements through Problem records and linked follow-up.
     likely_roles:
       - Operator
       - Engineer
       - Owner
       - Support Agent
-    draft_steps:
+    steps:
       - Identify recurring issue or root cause.
       - Capture the underlying or recurring cause through Problem when incidents or operational evidence support it.
       - Decide whether improvement requires a Requirement, Task, Risk, Decision, or Change.
@@ -182,13 +182,13 @@ workflows:
 
   - id: risk_control_management
     name: Risk and control management
-    draft_purpose: Identify risks and define controls or evidence requirements.
+    purpose: Identify risks and define controls or evidence requirements.
     likely_roles:
       - Owner
       - Operator
       - Tester
       - Engineer
-    draft_steps:
+    steps:
       - Identify risk.
       - Decide owner and impact.
       - Define control or mitigation.
@@ -197,13 +197,13 @@ workflows:
 
   - id: audit_evidence_capture
     name: Audit and evidence capture
-    draft_purpose: Preserve evidence for decisions, verification, controls, releases, deployments, and approvals.
+    purpose: Preserve evidence for decisions, verification, controls, releases, deployments, and approvals.
     likely_roles:
       - Operator
       - Tester
       - Engineer
       - Owner
-    draft_steps:
+    steps:
       - Identify required evidence.
       - Capture or link evidence.
       - Record responsible person and timestamp.

package/website/account.html

@@ -0,0 +1,57 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>DX Complete Account</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>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </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="./operating-guide.html">Operating Guide</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">Account</p>
+          <h1>Set Up A Workspace</h1>
+          <p class="lede">
+            Sign in with Google, create a workspace, and save the service values needed by your project.
+          </p>
+
+          <div class="account-panel" data-account>
+            <p>Loading account state...</p>
+          </div>
+        </section>
+      </main>
+    </div>
+
+    <script src="./app.js?v=5"></script>
+  </body>
+</html>

package/website/app.js

@@ -34,3 +34,180 @@ roleButtons.forEach((button, index) => {
     detailPanel.textContent = detail;
   });
 });
+
+const accountPanel = document.querySelector("[data-account]");
+let accountState;
+
+if (accountPanel) {
+  loadAccount();
+}
+
+async function loadAccount() {
+  accountPanel.innerHTML = `<p>Loading account state...</p>`;
+
+  try {
+    const response = await fetch("/api/dxcomplete/web/session", {
+      credentials: "same-origin"
+    });
+    accountState = await response.json();
+    renderAccount();
+  } catch {
+    accountPanel.innerHTML = `
+      <div class="account-message account-message--error">
+        Account state could not be loaded. Try again in a moment.
+      </div>
+    `;
+  }
+}
+
+function renderAccount(created) {
+  const error = new URLSearchParams(window.location.search).get("error");
+
+  if (!accountState?.authenticated) {
+    accountPanel.innerHTML = `
+      ${error ? `<div class="account-message account-message--error">Sign in could not be completed.</div>` : ""}
+      <div class="account-intro">
+        <p>Use Google sign in to create and view your DX Complete workspaces.</p>
+        <a class="account-primary" href="${escapeHtml(accountState?.signInUrl || "/api/dxcomplete/web/auth/google/start?returnTo=/account.html")}">Sign in with Google</a>
+      </div>
+    `;
+    return;
+  }
+
+  const workspaces = Array.isArray(accountState.workspaces) ? accountState.workspaces : [];
+  accountPanel.innerHTML = `
+    <div class="account-bar">
+      <div>
+        <span>Signed in</span>
+        <strong>${escapeHtml(accountState.actor?.email || accountState.actor?.displayName || "Google account")}</strong>
+      </div>
+      <button class="account-secondary" type="button" data-account-logout>Sign out</button>
+    </div>
+
+    <form class="account-form" data-account-form>
+      <label for="workspace-name">Workspace name</label>
+      <div class="account-form__row">
+        <input id="workspace-name" name="name" type="text" minlength="2" maxlength="120" required autocomplete="organization" />
+        <button class="account-primary" type="submit">Create workspace</button>
+      </div>
+      <p>Use a service or project name that your team will recognize later.</p>
+    </form>
+
+    <div data-account-result>
+      ${created ? renderCreatedWorkspace(created) : ""}
+    </div>
+
+    <div class="account-list">
+      <h2>Your Workspaces</h2>
+      ${workspaces.length ? workspaces.map(renderWorkspaceSummary).join("") : "<p>No workspaces yet.</p>"}
+    </div>
+  `;
+
+  accountPanel.querySelector("[data-account-logout]")?.addEventListener("click", logoutAccount);
+  accountPanel.querySelector("[data-account-form]")?.addEventListener("submit", createWorkspace);
+}
+
+async function createWorkspace(event) {
+  event.preventDefault();
+  const form = event.currentTarget;
+  const result = accountPanel.querySelector("[data-account-result]");
+  const button = form.querySelector("button[type='submit']");
+  const formData = new FormData(form);
+  const name = String(formData.get("name") || "");
+
+  button.disabled = true;
+  result.innerHTML = `<div class="account-message">Creating workspace...</div>`;
+
+  try {
+    const response = await fetch("/api/dxcomplete/web/workspaces", {
+      method: "POST",
+      credentials: "same-origin",
+      headers: {
+        "content-type": "application/json",
+        "x-dxc-csrf-token": accountState.csrfToken
+      },
+      body: JSON.stringify({ name })
+    });
+    const body = await response.json();
+
+    if (!response.ok) {
+      throw new Error(body.error_description || "Workspace could not be created.");
+    }
+
+    form.reset();
+    await refreshAccountState();
+    renderAccount(body);
+  } catch (error) {
+    result.innerHTML = `
+      <div class="account-message account-message--error">
+        ${escapeHtml(error instanceof Error ? error.message : "Workspace could not be created.")}
+      </div>
+    `;
+  } finally {
+    button.disabled = false;
+  }
+}
+
+async function logoutAccount() {
+  await fetch("/api/dxcomplete/web/logout", {
+    method: "POST",
+    credentials: "same-origin",
+    headers: {
+      "x-dxc-csrf-token": accountState.csrfToken
+    }
+  }).catch(() => undefined);
+
+  await loadAccount();
+}
+
+async function refreshAccountState() {
+  const response = await fetch("/api/dxcomplete/web/session", {
+    credentials: "same-origin"
+  });
+  accountState = await response.json();
+}
+
+function renderCreatedWorkspace(created) {
+  const env = created.install?.env || {};
+  const workspace = created.install?.workspaceConfig || {};
+  const envBlock = [
+    `DXC_SERVICE_URL=${env.DXC_SERVICE_URL || ""}`,
+    `DXC_SERVICE_CLIENT_ID=${env.DXC_SERVICE_CLIENT_ID || ""}`,
+    `DXC_SERVICE_CLIENT_SECRET=${env.DXC_SERVICE_CLIENT_SECRET || ""}`
+  ].join("\n");
+  const workspaceBlock = JSON.stringify(workspace, null, 2);
+
+  return `
+    <div class="account-result">
+      <h2>Workspace Created</h2>
+      <p>Save these values now. The secret is shown only once.</p>
+      <h3>Service Values</h3>
+      <pre><code>${escapeHtml(envBlock)}</code></pre>
+      <h3>Workspace JSON</h3>
+      <pre><code>${escapeHtml(workspaceBlock)}</code></pre>
+    </div>
+  `;
+}
+
+function renderWorkspaceSummary(workspace) {
+  const clients = Array.isArray(workspace.serviceClients) ? workspace.serviceClients : [];
+  return `
+    <article class="account-workspace">
+      <h3>${escapeHtml(workspace.name || workspace.workspaceId)}</h3>
+      <p>${escapeHtml(workspace.workspaceId || "")}</p>
+      <dl>
+        <div><dt>Roles</dt><dd>${escapeHtml((workspace.roles || []).join(", ") || "member")}</dd></div>
+        <div><dt>Service clients</dt><dd>${clients.length}</dd></div>
+      </dl>
+    </article>
+  `;
+}
+
+function escapeHtml(value) {
+  return String(value)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+}

package/website/flow.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/glossary.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/index.html

@@ -17,6 +17,10 @@
           <small>Plan, deliver, run, measure</small>
         </span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
 
     <div class="layout">

package/website/objects.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/operating-guide.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/outcomes.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-build.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-elicit.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-go-live.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-measure.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-operate.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-orient.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/phase-weigh.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">

package/website/roles.html

@@ -13,6 +13,10 @@
         <span class="brand-mark" aria-hidden="true">DX</span>
         <span><strong>DX Complete</strong><small>Plan, deliver, run, measure</small></span>
       </div>
+      <div class="topbar__actions">
+        <a class="topbar__link" href="https://www.npmjs.com/package/dxcomplete" target="_blank" rel="noreferrer">npm</a>
+        <a class="topbar__link" href="./account.html">Sign in</a>
+      </div>
     </header>
     <div class="layout">
       <aside class="sidebar" aria-label="Documentation pages">