@piagent/platform 1.3.0 → 1.4.0

package/schemas/piagent-webui/transcript-v1.schema.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/piagent-webui/transcript-v1.schema.json",
+  "title": "Piagent WebUI bounded transcript projection v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "version",
+    "generatedAt",
+    "identity",
+    "revision",
+    "eventCursor",
+    "state",
+    "items",
+    "page",
+    "reasonCode"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-webui-transcript-v1" },
+    "generatedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+    "identity": { "$ref": "#/$defs/identity" },
+    "revision": { "$ref": "common-v1.schema.json#/$defs/domainRevision" },
+    "eventCursor": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+    "state": { "enum": ["ready", "unavailable"] },
+    "items": {
+      "type": "array",
+      "maxItems": 200,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/transcriptItem" }
+    },
+    "page": { "$ref": "#/$defs/page" },
+    "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "ready" } }, "required": ["state"] },
+      "then": { "properties": { "reasonCode": { "type": "null" } } }
+    },
+    {
+      "if": { "properties": { "state": { "const": "unavailable" } }, "required": ["state"] },
+      "then": {
+        "properties": {
+          "items": { "type": "array", "maxItems": 0 },
+          "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" },
+          "page": {
+            "type": "object",
+            "properties": {
+              "nextBeforeCursor": { "type": "null" },
+              "hasOlder": { "const": false }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["projectRef", "runtimeInstanceId", "sessionRef", "taskId", "taskRunId", "agentOperationId", "toolCallId"],
+      "properties": {
+        "projectRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "runtimeInstanceId": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "sessionRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "taskId": { "$ref": "common-v1.schema.json#/$defs/nullablePublicId" },
+        "taskRunId": { "$ref": "common-v1.schema.json#/$defs/nullablePublicId" },
+        "agentOperationId": { "type": "null" },
+        "toolCallId": { "type": "null" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "taskRunId": { "type": "string" } }, "required": ["taskRunId"] },
+          "then": { "properties": { "taskId": { "$ref": "common-v1.schema.json#/$defs/publicId" } } }
+        }
+      ]
+    },
+    "nullableCount": {
+      "anyOf": [
+        { "type": "integer", "minimum": 0, "maximum": 1000000000 },
+        { "type": "null" }
+      ]
+    },
+    "safeTranscriptText": {
+      "type": "string",
+      "maxLength": 16384,
+      "pattern": "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]*$"
+    },
+    "nullableSafeTranscriptText": {
+      "anyOf": [
+        { "$ref": "#/$defs/safeTranscriptText" },
+        { "type": "null" }
+      ]
+    },
+    "content": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "text", "textChars", "digest", "truncated", "redacted", "imageCount", "reasonCode"],
+      "properties": {
+        "state": { "enum": ["available", "redacted", "unavailable"] },
+        "text": { "$ref": "#/$defs/nullableSafeTranscriptText" },
+        "textChars": { "$ref": "#/$defs/nullableCount" },
+        "digest": {
+          "anyOf": [
+            { "$ref": "common-v1.schema.json#/$defs/digest" },
+            { "type": "null" }
+          ]
+        },
+        "truncated": { "type": "boolean" },
+        "redacted": { "type": "boolean" },
+        "imageCount": { "type": "integer", "minimum": 0, "maximum": 32 },
+        "reasonCode": { "$ref": "common-v1.schema.json#/$defs/nullableReasonCode" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "const": "available" } }, "required": ["state"] },
+          "then": {
+            "properties": {
+              "text": { "$ref": "#/$defs/safeTranscriptText" },
+              "textChars": { "type": "integer", "minimum": 0, "maximum": 1000000000 },
+              "digest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+              "redacted": { "const": false },
+              "reasonCode": { "type": "null" }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "state": { "const": "redacted" } }, "required": ["state"] },
+          "then": {
+            "properties": {
+              "text": { "$ref": "#/$defs/safeTranscriptText" },
+              "textChars": { "type": "integer", "minimum": 0, "maximum": 1000000000 },
+              "digest": { "$ref": "common-v1.schema.json#/$defs/digest" },
+              "redacted": { "const": true },
+              "reasonCode": { "const": "sensitive-values-redacted" }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "state": { "const": "unavailable" } }, "required": ["state"] },
+          "then": {
+            "properties": {
+              "text": { "type": "null" },
+              "textChars": { "type": "null" },
+              "digest": { "type": "null" },
+              "truncated": { "const": false },
+              "redacted": { "const": false },
+              "reasonCode": { "$ref": "common-v1.schema.json#/$defs/reasonCode" }
+            }
+          }
+        }
+      ]
+    },
+    "toolCall": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["toolCallRef", "toolName", "state"],
+      "properties": {
+        "toolCallRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "toolName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80,
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@~-]{0,79}$"
+        },
+        "state": { "enum": ["requested", "completed", "failed", "unknown"] }
+      }
+    },
+    "transcriptItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "messageRef",
+        "parentMessageRef",
+        "role",
+        "recordedAt",
+        "agentOperationId",
+        "turnIndex",
+        "content",
+        "toolCalls"
+      ],
+      "properties": {
+        "messageRef": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" },
+        "parentMessageRef": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "role": { "enum": ["user", "assistant", "tool-result"] },
+        "recordedAt": { "$ref": "common-v1.schema.json#/$defs/timestamp" },
+        "agentOperationId": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "turnIndex": { "$ref": "#/$defs/nullableCount" },
+        "content": { "$ref": "#/$defs/content" },
+        "toolCalls": {
+          "type": "array",
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/toolCall" }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "turnIndex": { "type": "integer" } }, "required": ["turnIndex"] },
+          "then": { "properties": { "agentOperationId": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" } } }
+        },
+        {
+          "if": { "properties": { "role": { "const": "tool-result" } }, "required": ["role"] },
+          "then": {
+            "properties": {
+              "content": {
+                "type": "object",
+                "properties": {
+                  "state": { "const": "unavailable" },
+                  "reasonCode": { "const": "tool-output-in-activity-preview" }
+                }
+              },
+              "toolCalls": { "type": "array", "minItems": 1, "maxItems": 1 }
+            }
+          }
+        }
+      ]
+    },
+    "page": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["beforeCursor", "nextBeforeCursor", "hasOlder", "limit", "truncated"],
+      "properties": {
+        "beforeCursor": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "nextBeforeCursor": { "$ref": "common-v1.schema.json#/$defs/nullableOpaqueRef" },
+        "hasOlder": { "type": "boolean" },
+        "limit": { "type": "integer", "minimum": 1, "maximum": 200 },
+        "truncated": { "type": "boolean" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "hasOlder": { "const": false } }, "required": ["hasOlder"] },
+          "then": { "properties": { "nextBeforeCursor": { "type": "null" } } }
+        },
+        {
+          "if": { "properties": { "hasOlder": { "const": true } }, "required": ["hasOlder"] },
+          "then": { "properties": { "nextBeforeCursor": { "$ref": "common-v1.schema.json#/$defs/opaqueRef" } } }
+        }
+      ]
+    }
+  }
+}

package/schemas/task-baseline-manifest.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/task-baseline-manifest.schema.json",
+  "title": "Piagent task baseline manifest v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "version", "taskId", "taskRunId", "sessionIdentityHash",
+    "capturedAt", "retentionUntil", "baselineDigestAlgorithm", "baselineTreeDigest",
+    "captureState", "reasonCode", "limits", "roots", "integrityDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-task-baseline-manifest-v1" },
+    "taskId": { "$ref": "#/$defs/publicId" },
+    "taskRunId": { "$ref": "#/$defs/publicId" },
+    "sessionIdentityHash": { "$ref": "#/$defs/digest" },
+    "capturedAt": { "$ref": "#/$defs/timestamp" },
+    "retentionUntil": { "$ref": "#/$defs/timestamp" },
+    "baselineDigestAlgorithm": { "const": "wt-content-v2" },
+    "baselineTreeDigest": { "type": "string", "pattern": "^wt-content-v2:[a-f0-9]{64}$" },
+    "captureState": { "enum": ["current", "degraded", "unavailable"] },
+    "reasonCode": { "$ref": "#/$defs/nullableReasonCode" },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxEntries", "maxFileBytes", "maxTotalBytes", "capturedBytes"],
+      "properties": {
+        "maxEntries": { "type": "integer", "minimum": 1, "maximum": 2000 },
+        "maxFileBytes": { "type": "integer", "minimum": 1024, "maximum": 16777216 },
+        "maxTotalBytes": { "type": "integer", "minimum": 1048576, "maximum": 268435456 },
+        "capturedBytes": { "type": "integer", "minimum": 0, "maximum": 268435456 }
+      }
+    },
+    "roots": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/root" }
+    },
+    "integrityDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "captureState": { "const": "current" } }, "required": ["captureState"] },
+      "then": { "properties": { "reasonCode": { "type": "null" } } },
+      "else": { "properties": { "reasonCode": { "$ref": "#/$defs/reasonCode" } } }
+    }
+  ],
+  "$defs": {
+    "publicId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@~-]{0,159}$" },
+    "opaqueRef": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9._~-]{0,159}$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "timestamp": { "type": "string", "format": "date-time", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$" },
+    "reasonCode": { "type": "string", "minLength": 1, "maxLength": 96, "pattern": "^[a-z0-9][a-z0-9.-]{0,95}$" },
+    "nullableReasonCode": { "anyOf": [{ "$ref": "#/$defs/reasonCode" }, { "type": "null" }] },
+    "oid": { "anyOf": [{ "type": "string", "pattern": "^[a-f0-9]{40,64}$" }, { "type": "null" }] },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "pathRef", "pathDigest", "repoPathBase64", "state", "reasonCode", "contentRef",
+        "byteLength", "mode", "headObject", "indexObject"
+      ],
+      "properties": {
+        "pathRef": { "$ref": "#/$defs/opaqueRef" },
+        "pathDigest": { "$ref": "#/$defs/digest" },
+        "repoPathBase64": { "anyOf": [{ "type": "string", "maxLength": 4096, "pattern": "^[A-Za-z0-9_-]*$" }, { "type": "null" }] },
+        "state": { "enum": ["blob", "absent", "symlink", "submodule", "protected", "oversized", "unavailable"] },
+        "reasonCode": { "$ref": "#/$defs/nullableReasonCode" },
+        "contentRef": { "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+        "byteLength": { "type": "integer", "minimum": 0, "maximum": 16777216 },
+        "mode": { "type": "string", "pattern": "^[0-7]{6}$" },
+        "headObject": { "$ref": "#/$defs/oid" },
+        "indexObject": { "$ref": "#/$defs/oid" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "enum": ["blob", "symlink"] } }, "required": ["state"] },
+          "then": { "properties": { "contentRef": { "$ref": "#/$defs/digest" }, "reasonCode": { "type": "null" } } },
+          "else": { "properties": { "contentRef": { "type": "null" } } }
+        },
+        {
+          "if": { "properties": { "state": { "enum": ["protected", "oversized", "unavailable"] } }, "required": ["state"] },
+          "then": { "properties": { "reasonCode": { "$ref": "#/$defs/reasonCode" } } },
+          "else": { "properties": { "reasonCode": { "type": "null" } } }
+        }
+      ]
+    },
+    "root": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repoRef", "projectPath", "headState", "headOid", "workspaceRevision",
+        "indexRevision", "state", "reasonCode", "entries"
+      ],
+      "properties": {
+        "repoRef": { "$ref": "#/$defs/opaqueRef" },
+        "projectPath": { "type": "string", "maxLength": 1024, "pattern": "^(?:\\.|(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\u0000-\\u001F\\u007F\\\\]+)$" },
+        "headState": { "enum": ["head", "unborn", "unavailable"] },
+        "headOid": { "$ref": "#/$defs/oid" },
+        "workspaceRevision": { "$ref": "#/$defs/opaqueRef" },
+        "indexRevision": { "$ref": "#/$defs/opaqueRef" },
+        "state": { "enum": ["current", "unavailable"] },
+        "reasonCode": { "$ref": "#/$defs/nullableReasonCode" },
+        "entries": { "type": "array", "maxItems": 2000, "items": { "$ref": "#/$defs/entry" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "headState": { "const": "head" } }, "required": ["headState"] },
+          "then": { "properties": { "headOid": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" } } },
+          "else": { "properties": { "headOid": { "type": "null" } } }
+        },
+        {
+          "if": { "properties": { "state": { "const": "current" } }, "required": ["state"] },
+          "then": { "properties": { "reasonCode": { "type": "null" } } },
+          "else": { "properties": { "reasonCode": { "$ref": "#/$defs/reasonCode" } } }
+        }
+      ]
+    }
+  }
+}

package/schemas/verifier-file-snapshot.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://piagent.io.vn/schemas/verifier-file-snapshot.schema.json",
+  "title": "Piagent verifier file snapshot v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion", "version", "attemptId", "attemptRef", "taskId", "taskRunId",
+    "sessionIdentityHash", "toolCallIdentityHash", "commandDigest", "observedAt", "capturedAt",
+    "retentionUntil", "exitCode", "outcome", "treeDigest", "fileCount", "exposedPathCount",
+    "files", "integrityDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "version": { "const": "piagent-verifier-file-snapshot-v1" },
+    "attemptId": { "type": "string", "pattern": "^verifier\\.[a-f0-9]{64}$" },
+    "attemptRef": { "type": "string", "pattern": "^verifier-evidence\\.[a-f0-9]{64}$" },
+    "taskId": { "$ref": "#/$defs/publicId" },
+    "taskRunId": { "$ref": "#/$defs/publicId" },
+    "sessionIdentityHash": { "$ref": "#/$defs/digest" },
+    "toolCallIdentityHash": { "$ref": "#/$defs/digest" },
+    "commandDigest": { "$ref": "#/$defs/digest" },
+    "observedAt": { "$ref": "#/$defs/timestamp" },
+    "capturedAt": { "$ref": "#/$defs/timestamp" },
+    "retentionUntil": { "$ref": "#/$defs/timestamp" },
+    "exitCode": { "type": "integer", "minimum": -2147483648, "maximum": 2147483647 },
+    "outcome": { "enum": ["passed", "failed"] },
+    "treeDigest": { "$ref": "#/$defs/treeDigest" },
+    "fileCount": { "type": "integer", "minimum": 0, "maximum": 2000 },
+    "exposedPathCount": { "type": "integer", "minimum": 0, "maximum": 2000 },
+    "files": {
+      "type": "array",
+      "maxItems": 2000,
+      "items": { "$ref": "#/$defs/file" }
+    },
+    "integrityDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "outcome": { "const": "passed" } }, "required": ["outcome"] },
+      "then": { "properties": { "exitCode": { "const": 0 } } },
+      "else": { "properties": { "exitCode": { "not": { "const": 0 } } } }
+    }
+  ],
+  "$defs": {
+    "publicId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@~-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "treeDigest": { "type": "string", "pattern": "^wt-content-v2:[a-f0-9]{64}$" },
+    "carrierDigest": { "type": "string", "pattern": "^wt-content-v2:[a-f0-9]{64}$" },
+    "timestamp": { "type": "string", "format": "date-time", "maxLength": 32 },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pathDigest", "repoPathBase64", "state", "reasonCode", "carrierDigest"],
+      "properties": {
+        "pathDigest": { "$ref": "#/$defs/digest" },
+        "repoPathBase64": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^[A-Za-z0-9_-]+$" }
+          ]
+        },
+        "state": { "enum": ["exact", "protected", "unavailable"] },
+        "reasonCode": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1, "maxLength": 96, "pattern": "^[a-z0-9][a-z0-9.-]*$" }
+          ]
+        },
+        "carrierDigest": { "$ref": "#/$defs/carrierDigest" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "state": { "const": "exact" } }, "required": ["state"] },
+          "then": { "properties": { "repoPathBase64": { "type": "string" }, "reasonCode": { "type": "null" } } },
+          "else": { "properties": { "repoPathBase64": { "type": "null" }, "reasonCode": { "type": "string" } } }
+        }
+      ]
+    }
+  }
+}

package/scripts/check-architecture.mjs

@@ -67,6 +67,7 @@ function inspectArchitecture({ root = repoRoot, config = readConfig() } = {}) {
   const errors = [];
   const files = [
     ...walkSources(path.join(root, "packages", "piagent-core")),
+    ...walkSources(path.join(root, "packages", "piagent-webui")),
     ...walkSources(path.join(root, "scripts"))
   ];
   const counts = {};

package/scripts/check-doc-languages.mjs

@@ -35,7 +35,23 @@ function inspectDocLanguages(root = repoRoot) {
     if (!viText.includes(enLink)) errors.push(`${pair.topic}: Vietnamese file does not link to ${enLink}`);
     if (!/[À-ỹĐđ]/u.test(viText)) errors.push(`${pair.topic}: Vietnamese file has no Vietnamese diacritics`);
   }
-  return { ok: errors.length === 0, errors, pairs: manifest.pairs.length, terms: manifest.preservedTechnicalTerms };
+  const rootDocs = fs.readdirSync(path.join(root, "docs"), { withFileTypes: true })
+    .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+    .map((entry) => path.join(root, "docs", entry.name));
+  const languageCounts = { en: 0, vi: 0, "en+vi": 0 };
+  for (const file of rootDocs) {
+    const text = fs.readFileSync(file, "utf8"), relative = path.relative(root, file).split(path.sep).join("/");
+    const match = text.slice(0, 1_024).match(/<!--\s*language:\s*(en\+vi|en|vi)(?:;\s*english-index:\s*([^\s]+))?\s*-->/i);
+    if (!match) { errors.push(`${relative}: missing explicit language marker`); continue; }
+    const language = match[1].toLowerCase(); languageCounts[language] += 1;
+    if (language === "vi") {
+      const index = match[2];
+      if (!index) errors.push(`${relative}: Vietnamese document has no English index`);
+      else if (!fs.existsSync(path.join(root, index))) errors.push(`${relative}: missing English index ${index}`);
+    }
+  }
+  return { ok: errors.length === 0, errors, pairs: manifest.pairs.length, rootDocuments: rootDocs.length,
+    languages: languageCounts, terms: manifest.preservedTechnicalTerms };
 }
 
 function main(argv = process.argv.slice(2)) {
@@ -56,7 +72,8 @@ function main(argv = process.argv.slice(2)) {
     process.stderr.write(`FAIL: documentation language check found ${result.errors.length} problem(s)\n${result.errors.map((error) => `- ${error}`).join("\n")}\n`);
     return 1;
   }
-  process.stdout.write(json ? `${JSON.stringify(result)}\n` : `PASS: ${result.pairs} EN/VI documentation pairs are complete\n`);
+  process.stdout.write(json ? `${JSON.stringify(result)}\n`
+    : `PASS: ${result.pairs} EN/VI pairs and ${result.rootDocuments} explicitly classified root documents are complete\n`);
   return 0;
 }
 

package/scripts/check-third-party-neutrality.mjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const exactFiles = [
+  "governance/piagent-webui/10-master-plan.md",
+  "governance/piagent-webui/40-session-hub-master-plan.md",
+  "governance/piagent-webui/STATUS.md"
+];
+const directories = ["governance/piagent-webui/decisions", "packages/piagent-webui/client/src"];
+const comparisonBrands = /\b(?:ChatGPT|OpenClaw|Open WebUI|Claude Desktop|9Router)\b/g;
+
+function filesIn(repositoryRoot, directory) {
+  return fs.readdirSync(path.join(repositoryRoot, directory), { withFileTypes: true })
+    .filter((entry) => entry.isFile() && /\.(?:md|tsx?|css)$/.test(entry.name))
+    .map((entry) => path.join(directory, entry.name));
+}
+
+export function inspectThirdPartyNeutrality(repositoryRoot = root) {
+  const candidates = [...exactFiles, ...directories.flatMap((directory) => filesIn(repositoryRoot, directory))]
+    .filter((file) => !file.includes("/decisions/WUI") || /\/decisions\/WUI5-/.test(file));
+  const violations = [];
+  for (const file of candidates) {
+    const text = fs.readFileSync(path.join(repositoryRoot, file), "utf8");
+    for (const match of text.matchAll(comparisonBrands)) {
+      const line = text.slice(0, match.index).split("\n").length;
+      violations.push({ file, line, keyword: match[0] });
+    }
+  }
+  return { ok: violations.length === 0, checkedFiles: candidates.length, violations };
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const result = inspectThirdPartyNeutrality();
+  if (!result.ok) {
+    process.stderr.write(`FAIL: third-party comparison branding found\n${result.violations
+      .map((item) => `- ${item.file}:${item.line} ${item.keyword}`).join("\n")}\n`);
+    process.exit(1);
+  }
+  process.stdout.write(`PASS: ${result.checkedFiles} active WebUI files use provider-neutral product language\n`);
+}

package/scripts/install-global.sh

@@ -677,7 +677,7 @@ echo "  /login"
 echo "  /model          # or Ctrl+L: select provider/model from Pi selector"
 echo "  /scoped-models  # optional: edit Ctrl+P model cycle scope"
 if [[ "$WITH_MCP" == true ]]; then
-  echo "  /mcp            # inspect MCP servers; authenticate Figma/GitHub only when needed"
+  echo "  /mcp            # inspect MCP servers; authenticate approved remote servers only when needed"
 fi
 echo "  /subagents-doctor"
 echo "  /workflow task Implement <task>  # parent may auto-delegate scout/planner/reviewer"

package/scripts/piagent-cli.mjs

@@ -23,12 +23,26 @@ const scriptByCommand = {
   "piagent-migrate": "scripts/migrate-project-state.mjs",
   "piagent-import-instructions": "scripts/import-agent-instructions.mjs",
   "piagent-auto": "scripts/pi-auto.sh",
-  "piagent-context": "scripts/context-engine.mjs"
+  "piagent-context": "scripts/context-engine.mjs",
+  "piagent-webui": "scripts/piagent-webui-launcher.mjs",
+  "piagent-dashboard": "scripts/piagent-dashboard.mjs"
 };
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const invokedAs = path.basename(process.argv[1] ?? "");
-const script = scriptByCommand[invokedAs];
+let forwardedArgs = process.argv.slice(2);
+let script = scriptByCommand[invokedAs];
+
+if (invokedAs === "piagent") {
+  const subcommand = forwardedArgs[0];
+  if (subcommand === "dashboard") {
+    script = "scripts/piagent-dashboard.mjs";
+    forwardedArgs = forwardedArgs.slice(1);
+  } else if ([undefined, "help", "--help", "-h"].includes(subcommand)) {
+    console.log("Usage: piagent dashboard [open|status|stop|restart|doctor] [--no-open] [--json]");
+    process.exit(0);
+  }
+}
 
 if (!script) {
   console.error(`Unknown Pi Agent command: ${invokedAs || "(unknown)"}`);
@@ -58,7 +72,7 @@ const runner = target.endsWith(".mjs") ? process.execPath : "bash";
 const runnerArgs = target.endsWith(".mjs")
   ? ["--disable-warning=ExperimentalWarning", "--import", path.join(sourceRoot, "scripts", "register-typescript-loader.mjs"), target]
   : [target];
-const child = spawn(runner, [...runnerArgs, ...process.argv.slice(2)], {
+const child = spawn(runner, [...runnerArgs, ...forwardedArgs], {
   cwd: process.cwd(),
   env: process.env,
   stdio: "inherit"