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
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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", "
|
|
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.
|
|
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
|
-
"
|
|
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(`
|
|
476
|
+
console.log(`runtime-work-order
|
|
477
477
|
|
|
478
478
|
Usage:
|
|
479
|
-
node scripts/
|
|
480
|
-
node scripts/
|
|
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
|
|
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", "
|
|
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"),
|