dxcomplete 0.2.0 → 0.2.1

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.
package/README.md CHANGED
@@ -113,7 +113,7 @@ DX Complete uses one package version, one workspace compatibility gate, and one
113
113
 
114
114
  The MCP `surfaceVersion` field is a stable surface identifier. Use `surfaceFingerprint` for exact surface reconciliation and `workspaceCompatibility` for upgrade decisions.
115
115
 
116
- ## Runtime Dogfood
116
+ ## Runtime and MCP
117
117
 
118
118
  The documentation scaffold is the first milestone. The next layer is a hosted runtime and MCP server so DX Complete can coordinate its own records. The runtime now treats Workspace as the boundary for one service scope.
119
119
 
@@ -148,11 +148,11 @@ npm run build
148
148
  npm run runtime:check
149
149
  ```
150
150
 
151
- The first runtime collections cover workspaces, statements, journal entries, environments, components, estimates, benefits, expectations, requirements, commitments, deferrals, tasks, changes, decisions, and risks. Dogfooding should use the normal MCP tools to create and link those records inside the intended workspace. Workspace-scoped lifecycle records receive a human-readable reference such as `REQ-0001` while UUID remains the primary key and link target.
151
+ The first runtime collections cover workspaces, statements, journal entries, environments, components, estimates, benefits, expectations, requirements, commitments, deferrals, tasks, changes, decisions, and risks. Use the MCP tools to create and link those records inside the intended workspace. Workspace-scoped lifecycle records receive a human-readable reference such as `REQ-0001` while UUID remains the primary key and link target.
152
152
 
153
153
  Environment and Component records form the Operational Registry. The registry is an inventory of operational state: what exists in each environment, where it lives, and which secret names or locations are relevant. It is not monitoring, diagnostics, a secret vault, an event log, or a runbook engine. Secret pointers should identify stores and keys only; do not record secret values.
154
154
 
155
- Useful MCP tools for dogfooding include:
155
+ Useful MCP tools include:
156
156
 
157
157
  - `runtime_status` to confirm the connected server process and MCP surface fingerprint.
158
158
  - `get_process_guide` to give MCP clients the current phase guide: Orient, Elicit, Weigh, Build, Go Live, Operate, and Measure.
@@ -175,11 +175,11 @@ Useful MCP tools for dogfooding include:
175
175
  - `link_records` and `unlink_records` for explicit relationships when a typed tool does not already create or remove the link.
176
176
  - `archive_record` for cleanup without deleting evidence.
177
177
 
178
- Hosted MCP is exposed at `/api/mcp`. The workspace route uses Streamable HTTP, advertises OAuth metadata for remote MCP clients, proxies OAuth through the central service, sends users through Google OAuth, and then returns DX Complete bearer tokens scoped to the configured workspace. The installed repo supplies workspace identity through `dxcomplete/workspace.json`; the central service stores workspace memberships and executes MCP tools. The current dogfood workspace grants Owner access to `sam.bourque@gmail.com`.
178
+ Hosted MCP is exposed at `/api/mcp`. The workspace route uses Streamable HTTP, advertises OAuth metadata for remote MCP clients, proxies OAuth through the central service, sends users through Google OAuth, and then returns DX Complete bearer tokens scoped to the configured workspace. The installed repo supplies workspace identity through `dxcomplete/workspace.json`; the central service stores workspace memberships and executes MCP tools.
179
179
 
180
180
  The central service exposes internal routes under `/api/dxcomplete/service/*`. Workspace servers authenticate to those routes with `DXC_SERVICE_CLIENT_ID` and `DXC_SERVICE_CLIENT_SECRET`. The provisioning route creates the workspace record, seeds the Owner membership, and returns the one-time workspace service-client secret.
181
181
 
182
- For Google OAuth provisioning, set the callback URL to `/api/auth/callback/google` on the hosted workspace domain. For the dogfood deployment, use `https://dxcomplete.directeddomains.com/api/auth/callback/google`.
182
+ For Google OAuth provisioning, set the callback URL to `/api/auth/callback/google` on the hosted workspace domain.
183
183
 
184
184
  Use `runtime_status` to reconcile the MCP-facing contract. `surfaceFingerprint` is the single client-facing identity for the tools, tool schemas, process guide, and on-demand doc references together. `get_process_guide` and `get_doc` return the same `surfaceVersion` and `surfaceFingerprint`, so an MCP client can treat a mismatch as a stale or inconsistent surface and refresh before continuing.
185
185
 
@@ -191,14 +191,6 @@ The Journal is shared workspace context, not a private ticket. It is for useful
191
191
 
192
192
  The Operating Guide explains record routing by role. Engineer/Codex work defaults to Requirement -> Task. Tester evidence usually belongs in Task entries, review notes, Risk, Decision, or Journal. Operator work uses Change for run-side alterations, Incident for specific service-impacting occurrences, Problem for underlying or recurring causes, and Environment or Component for operational inventory. Support Agent work starts with DX Complete Ticket, then promotes to shared records only when needed.
193
193
 
194
- For dogfood maintenance work that needs direct database access, batch the work in one process instead of running repeated one-off Mongo commands:
195
-
196
- ```sh
197
- npm run dogfood:work-order -- --plan ./work-order.json
198
- ```
199
-
200
- The work-order runner opens one runtime connection, runs ticket summaries, ticket reads, DX Complete replies, simple archives, link-residue checks, or a local one-off module, then closes the connection. It is a maintainer tool for dogfood cleanup and migration work; the normal product path remains the hosted MCP tools.
201
-
202
194
  Run the hosted MCP smoke test after runtime changes:
203
195
 
204
196
  ```sh
package/dist/validate.js CHANGED
@@ -70,7 +70,7 @@ function packageRequiredFiles() {
70
70
  path.join("templates", "AGENTS.md"),
71
71
  path.join("scripts", "check-env-surface.mjs"),
72
72
  path.join("scripts", "smoke-mcp-http.mjs"),
73
- path.join("scripts", "dogfood-work-order.mjs"),
73
+ path.join("scripts", "runtime-work-order.mjs"),
74
74
  path.join("scripts", "check-public-copy.mjs"),
75
75
  path.join("scripts", "check-service-boundary.mjs"),
76
76
  path.join("templates", "next", "pages", "api", "mcp.js"),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dxcomplete",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "Install a Next.js workspace scaffold for DX Complete process records, MCP routes, and service lifecycle documentation.",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -61,7 +61,7 @@
61
61
  "smoke:mcp:http:change": "node scripts/smoke-mcp-http.mjs --area=change",
62
62
  "smoke:mcp:http:tickets": "node scripts/smoke-mcp-http.mjs --area=tickets",
63
63
  "smoke:mcp:http:journal": "node scripts/smoke-mcp-http.mjs --area=journal",
64
- "dogfood:work-order": "node scripts/dogfood-work-order.mjs",
64
+ "runtime:work-order": "node scripts/runtime-work-order.mjs",
65
65
  "validate:package": "node dist/cli.js validate --target . --package-layout",
66
66
  "runtime:check": "node dist/cli.js check-runtime"
67
67
  },
@@ -473,14 +473,14 @@ function elapsedSeconds(started) {
473
473
  }
474
474
 
475
475
  function printHelp() {
476
- console.log(`dogfood-work-order
476
+ console.log(`runtime-work-order
477
477
 
478
478
  Usage:
479
- node scripts/dogfood-work-order.mjs --plan ./work-order.json
480
- node scripts/dogfood-work-order.mjs --module ./one-off.mjs
479
+ node scripts/runtime-work-order.mjs --plan ./work-order.json
480
+ node scripts/runtime-work-order.mjs --module ./one-off.mjs
481
481
 
482
482
  Purpose:
483
- Open Mongo once and batch dogfood reads, ticket replies, simple verification,
483
+ Open one runtime connection and batch ticket reads, ticket replies, simple verification,
484
484
  and optional one-off work-order modules.
485
485
 
486
486
  Plan shape:
package/src/validate.ts CHANGED
@@ -89,7 +89,7 @@ function packageRequiredFiles(): string[] {
89
89
  path.join("templates", "AGENTS.md"),
90
90
  path.join("scripts", "check-env-surface.mjs"),
91
91
  path.join("scripts", "smoke-mcp-http.mjs"),
92
- path.join("scripts", "dogfood-work-order.mjs"),
92
+ path.join("scripts", "runtime-work-order.mjs"),
93
93
  path.join("scripts", "check-public-copy.mjs"),
94
94
  path.join("scripts", "check-service-boundary.mjs"),
95
95
  path.join("templates", "next", "pages", "api", "mcp.js"),