@piagent/platform 1.2.12 → 1.2.14

package/packages/piagent-core/runtime/workflows/input-routing.ts

@@ -0,0 +1,113 @@
+import fs from "node:fs";
+import path from "node:path";
+
+import { redactSensitiveText } from "../../extensions/redaction-core.js";
+import { LONG_INPUT_CHARS, MAX_INLINE_COLLAPSED_TASK_CHARS } from "../runtime-limits.ts";
+
+export type FreshWorkflow = "task" | "scout" | "be-to-fe";
+
+export function looksLikeGovernedBoilerplate(text: string): boolean {
+  const lower = text.toLowerCase();
+  const markers = [
+    "mandatory flow",
+    "piagent_context",
+    "piagent_task_start",
+    "piagent_context_record",
+    "piagent_verify_record",
+    "piagent_task_gate_check",
+    "output format"
+  ];
+  return markers.filter((marker) => lower.includes(marker)).length >= 3;
+}
+
+function extractFencedBlockAfter(label: RegExp, text: string): string | undefined {
+  const labelMatch = label.exec(text);
+  if (!labelMatch || labelMatch.index === undefined) return undefined;
+  const rest = text.slice(labelMatch.index + labelMatch[0].length);
+  const fenced = /```(?:text|md|markdown)?\s*([\s\S]*?)```/i.exec(rest);
+  return fenced?.[1]?.trim();
+}
+
+export function stripLeadingWorkflowCommand(input: string): string {
+  return input
+    .replace(/^\/(?:piagent-workflow|workflow)\s+(?:task|scout|be-to-fe|review|plan|platform-improve|discuss|commit|pr)\b\s*/i, "")
+    .replace(/^\/(?:task|scout|be-to-fe|review|plan|platform-improve|discuss|commit|pr)\b\s*/i, "")
+    .trim();
+}
+
+export function extractTaskRequest(text: string): string {
+  const labeled =
+    extractFencedBlockAfter(/(?:implement|scout|review|plan)\s+(?:this\s+)?task\s*:?\s*/i, text) ??
+    extractFencedBlockAfter(/request\s*:?\s*/i, text);
+  if (labeled) return stripLeadingWorkflowCommand(labeled);
+
+  const firstFence = /```(?:text|md|markdown)?\s*([\s\S]*?)```/i.exec(text);
+  if (firstFence?.[1]?.trim()) return stripLeadingWorkflowCommand(firstFence[1].trim());
+
+  return stripLeadingWorkflowCommand(text.trim());
+}
+
+export function trimTaskForInline(input: string): string {
+  const normalized = stripLeadingWorkflowCommand(input).trim().replace(/\n{3,}/g, "\n\n");
+  if (normalized.length <= MAX_INLINE_COLLAPSED_TASK_CHARS) return normalized;
+  return `${normalized.slice(0, MAX_INLINE_COLLAPSED_TASK_CHARS).trim()}\n\n[Input truncated by piagent preflight. Put the full spec in a project file and reference that file.]`;
+}
+
+export function chooseFreshWorkflow(original: string, task: string): FreshWorkflow {
+  const semantic = stripLeadingWorkflowCommand(task || original).toLowerCase();
+  const starts = original.trim().toLowerCase();
+  const workflowStart = starts.match(/^\/(?:piagent-workflow|workflow)\s+(task|scout|be-to-fe)\b/);
+  if (workflowStart?.[1] === "be-to-fe") return "be-to-fe";
+  if (workflowStart?.[1] === "scout") return "scout";
+  if (workflowStart?.[1] === "task") return "task";
+  if (starts.startsWith("/be-to-fe")) return "be-to-fe";
+  if (starts.startsWith("/scout")) return "scout";
+  const asksForWrite = /\b(implement|support|surface|consume|write|change|fix)\b/.test(semantic);
+  if (/\b(scout|read-only|read only|audit|mapping|mapping matrix|map contract)\b/.test(semantic) && !asksForWrite) {
+    return "scout";
+  }
+  if (/\b(be|backend)\b/.test(semantic) && /\b(fe|frontend)\b/.test(semantic) && asksForWrite) {
+    return "be-to-fe";
+  }
+  return "task";
+}
+
+export function isPiagentWorkflowInput(text: string): boolean {
+  return /^\/(?:piagent-workflow|workflow|task|be-to-fe|scout|review|plan|platform-improve)\b/i.test(text.trim());
+}
+
+export function isFreshOrUtilityInput(text: string): boolean {
+  return /^\/(?:usage|logs|context|commands|permission|memory|onboard|name|fresh|fresh-task|fresh-scout|fresh-be-to-fe|task-preflight|piagent-usage|piagent-logs|piagent-session|piagent-context|piagent-commands|piagent-permission|model-options|memory-policy|onboard-project|setname|session|compact)\b/i.test(text.trim());
+}
+
+function taskInboxDir(cwd: string): string {
+  return path.join(cwd, ".pi", "task-inbox");
+}
+
+function writeTaskInbox(cwd: string, workflow: string, text: string): string {
+  fs.mkdirSync(taskInboxDir(cwd), { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const safeWorkflow = workflow.replace(/[^a-z0-9-]+/gi, "-").toLowerCase() || "task";
+  const fileName = `${stamp}-${safeWorkflow}.md`;
+  const absolute = path.join(taskInboxDir(cwd), fileName);
+  fs.writeFileSync(absolute, `${redactSensitiveText(text).text}\n`);
+  return path.relative(cwd, absolute).split(path.sep).join("/");
+}
+
+export function buildFreshCommand(cwd: string, workflow: FreshWorkflow, originalText: string, reason: string): string {
+  const task = extractTaskRequest(originalText);
+  if (originalText.length >= LONG_INPUT_CHARS) {
+    const intakePath = writeTaskInbox(cwd, workflow, originalText);
+    return `/fresh ${workflow} Read task intake from ${intakePath}. ${reason}`;
+  }
+  return `/fresh ${workflow} ${trimTaskForInline(task)}`;
+}
+
+export function shortTaskLabel(text: string): string {
+  const compact = text
+    .replace(/```[\s\S]*?```/g, " ")
+    .replace(/[^A-Za-z0-9\u00C0-\u1EF9_-]+/g, " ")
+    .trim()
+    .slice(0, 64);
+  return compact || "piagent task";
+}

package/packages/piagent-core/runtime/workflows/task-intake.ts

@@ -0,0 +1,73 @@
+import { classifyContextTask } from "../../extensions/context-engine.js";
+import { matchesProtectedPath, normalizePathCandidate } from "../../extensions/policy-core.js";
+import type { ReviewLens } from "../../extensions/guard-types.js";
+import { LONG_INPUT_CHARS } from "../runtime-limits.ts";
+
+const AUTO_INTAKE_MAX_PROMPT_CHARS = 700;
+const AUTO_INTAKE_CHANGE_INTENT = /\b(?:add|build|change|correct|create|fix|implement|modify|refactor|remove|rename|replace|update|write|sua|them|doi|cap nhat|xoa|tao)\b/i;
+const AUTO_INTAKE_READ_ONLY_LEAD = /^\s*\/?(?:analy[sz]e|audit|check|discuss|explain|inspect|plan|research|review|scout|summari[sz]e|why|how|can\s+(?:you|we)|kiem tra|nghien cuu|giai thich|danh gia)\b/i;
+const AUTO_INTAKE_MANUAL_RISK = /\b(?:credential|database|deploy|destructive|encryption|external provider|migration|payment|permission|production|publish|release|secret|schema migration|token rotation)\b/i;
+
+export const AUTO_INTAKE_SNAPSHOT_PATTERNS = [
+  "src/**", "app/**", "lib/**", "packages/**", "test/**", "tests/**", "spec/**", "__tests__/**"
+];
+
+function uniqueStrings(values: string[]): string[] {
+  return [...new Set(values)];
+}
+
+export function automaticTaskIntakeEligible(prompt: string, readProtectedPaths: string[]): boolean {
+  const text = String(prompt ?? "").trim();
+  if (!text || text.length > AUTO_INTAKE_MAX_PROMPT_CHARS) return false;
+  const signal = classifyContextTask(text);
+  if (signal.workflow !== "task" || !AUTO_INTAKE_CHANGE_INTENT.test(text)) return false;
+  if (AUTO_INTAKE_READ_ONLY_LEAD.test(text) || AUTO_INTAKE_MANUAL_RISK.test(text)) return false;
+  if (/\bpiagent_task_start\b/i.test(text)) return false;
+  return !signal.paths.some((candidate) => matchesProtectedPath(candidate, readProtectedPaths));
+}
+
+export function manualTaskIntakeEligible(prompt: string, readProtectedPaths: string[]): boolean {
+  const text = String(prompt ?? "").trim();
+  if (!text || text.length > LONG_INPUT_CHARS) return false;
+  const signal = classifyContextTask(text);
+  if (signal.workflow !== "task" || !AUTO_INTAKE_CHANGE_INTENT.test(text)) return false;
+  if (AUTO_INTAKE_READ_ONLY_LEAD.test(text) || /\bpiagent_task_start\b/i.test(text)) return false;
+  if (signal.paths.length === 0) return true;
+  return signal.paths.some((candidate) => !matchesProtectedPath(candidate, readProtectedPaths));
+}
+
+export function automaticTaskScope(prompt: string, context: Array<{ path: string }>): string[] {
+  const signal = classifyContextTask(prompt);
+  const explicit = signal.paths.filter((candidate) => candidate && candidate !== "." && !candidate.startsWith(".pi/"));
+  const navigated = context
+    .map((item) => normalizePathCandidate(item.path))
+    .filter((candidate): candidate is string => Boolean(
+      candidate
+      && candidate !== "."
+      && !candidate.startsWith(".pi/")
+      && !["AGENTS.md", "README.md", "REVIEW_GUIDELINES.md"].includes(candidate)
+      && /^(?:app|lib|packages|spec|src|test|tests|__tests__)\//.test(candidate)
+    ))
+    .slice(0, 8);
+  const scope = uniqueStrings([...explicit, ...navigated]);
+  if (scope.length === 0) scope.push("src/**", "app/**", "lib/**");
+  if (/\b(?:test|tests|verification|verify|kiem thu)\b/i.test(prompt)) {
+    scope.push("test/**", "tests/**", "spec/**", "__tests__/**");
+  }
+  return uniqueStrings(scope);
+}
+
+export function automaticReviewLenses(prompt: string): ReviewLens[] {
+  const lenses: ReviewLens[] = ["correctness", "tests", "scope"];
+  if (/\b(?:auth|authorization|credential|permission|security|session|secret|xac thuc|phan quyen|bao mat)\b/i.test(prompt)) {
+    lenses.push("security");
+  }
+  return lenses;
+}
+
+export function validTaskScopePattern(value: string): boolean {
+  const candidate = String(value ?? "").trim().replaceAll("\\", "/");
+  if (!candidate || /\s|\0/.test(candidate)) return false;
+  if (candidate.startsWith("/") || candidate.startsWith("~/") || /^[A-Za-z]:\//.test(candidate)) return false;
+  return !candidate.split("/").includes("..");
+}

package/scripts/build-docs-site.mjs

@@ -21,6 +21,7 @@ const SITE = {
   title: "Pi Agent Platform Docs",
   origin: "https://piagent.io.vn",
   repo: "https://github.com/Vt-mmm/piagent",
+  englishDocs: "https://github.com/Vt-mmm/piagent/blob/main/docs/en/README.md",
   facebook: "https://www.facebook.com/vinhtam0544/"
 };
 
@@ -130,6 +131,12 @@ const NAV = [
         title: "Ít context hơn, giữ nguyên chất lượng model",
         lead: "Index local, retrieval có xếp hạng, tool loading theo task, semantic compaction và telemetry minh bạch cho Agent Watch."
       },
+      {
+        slug: "benchmark",
+        nav: "Benchmark",
+        title: "Bằng chứng chất lượng và hiệu suất",
+        lead: "Production benchmark so sánh Piagent với surface codex-cli trên cùng model, cùng thinking level, 18 nhóm bài và 108 session được chấm tự động."
+      },
       {
         slug: "runtime",
         nav: "Runtime tools",
@@ -294,7 +301,8 @@ function renderPage(page, index, body, version) {
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v${version} docs</span>
+        <span class="pill"><span class="pill-dot"></span>v${version} docs · VI</span>
+        <a class="button" href="${SITE.englishDocs}" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
         <a class="button social" href="${SITE.repo}" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
@@ -329,6 +337,7 @@ ${renderPager(index)}
               <div class="footer-links" aria-label="External links">
                 <a href="${SITE.origin}" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
                 <a href="${SITE.repo}" target="_blank" rel="noopener noreferrer">GitHub repository</a>
+                <a href="${SITE.englishDocs}" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
                 <a href="${SITE.facebook}" target="_blank" rel="noopener noreferrer">Facebook profile</a>
               </div>
             </footer>

package/scripts/check-architecture.mjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const defaultConfigPath = path.join(repoRoot, "architecture", "layers.json");
+const SOURCE_EXTENSIONS = new Set([".js", ".mjs", ".cjs", ".ts", ".mts", ".cts"]);
+
+function normalizeRelative(value) {
+  return value.split(path.sep).join("/").replace(/^\.\//, "");
+}
+
+function sourceLineCount(text) {
+  if (!text) return 0;
+  const lines = text.split(/\r?\n/);
+  return lines.at(-1) === "" ? lines.length - 1 : lines.length;
+}
+
+function readConfig(configPath = defaultConfigPath) {
+  const parsed = JSON.parse(fs.readFileSync(configPath, "utf8"));
+  if (parsed?.schemaVersion !== 1 || !Array.isArray(parsed.layers)) {
+    throw new Error(`Unsupported architecture config: ${normalizeRelative(path.relative(repoRoot, configPath))}`);
+  }
+  return parsed;
+}
+
+function layerFor(relativeFile, config) {
+  const normalized = normalizeRelative(relativeFile);
+  for (const layer of config.layers) {
+    if ((layer.files ?? []).includes(normalized)) return layer.name;
+    if ((layer.roots ?? []).some((root) => normalized === root || normalized.startsWith(`${root}/`))) return layer.name;
+  }
+  return undefined;
+}
+
+function walkSources(root) {
+  if (!fs.existsSync(root)) return [];
+  const files = [];
+  const stack = [root];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+      if (entry.name === "node_modules" || entry.name === "dist" || entry.name === "coverage") continue;
+      const absolute = path.join(current, entry.name);
+      if (entry.isDirectory()) stack.push(absolute);
+      else if (entry.isFile() && SOURCE_EXTENSIONS.has(path.extname(entry.name))) files.push(absolute);
+    }
+  }
+  return files.sort();
+}
+
+function moduleSpecifiers(file, text) {
+  const specifiers = [];
+  const patterns = [
+    /\b(?:import|export)\s+(?:type\s+)?[\w*{},\s]+?\s+from\s+["']([^"']+)["']/g,
+    /\bimport\s*["']([^"']+)["']/g,
+    /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g
+  ];
+  for (const pattern of patterns) {
+    for (const match of text.matchAll(pattern)) specifiers.push(match[1]);
+  }
+  return specifiers;
+}
+
+function inspectArchitecture({ root = repoRoot, config = readConfig() } = {}) {
+  const errors = [];
+  const files = [
+    ...walkSources(path.join(root, "packages", "piagent-core")),
+    ...walkSources(path.join(root, "scripts"))
+  ];
+  const counts = {};
+
+  for (const absolute of files) {
+    const relative = normalizeRelative(path.relative(root, absolute));
+    const layer = layerFor(relative, config);
+    if (!layer) {
+      errors.push(`${relative}: source file is not assigned to an architecture layer`);
+      continue;
+    }
+    counts[layer] = (counts[layer] ?? 0) + 1;
+    const text = fs.readFileSync(absolute, "utf8");
+    const lineCount = sourceLineCount(text);
+    const budget = config.lineBudgets.files[relative] ?? config.lineBudgets.defaults[layer];
+    if (Number.isInteger(budget) && lineCount > budget) {
+      errors.push(`${relative}: ${lineCount} lines exceeds the ${layer} budget of ${budget}`);
+    }
+
+    for (const specifier of moduleSpecifiers(relative, text)) {
+      if (!specifier.startsWith(".")) continue;
+      const target = normalizeRelative(path.relative(root, path.resolve(path.dirname(absolute), specifier)));
+      const targetLayer = layerFor(target, config);
+      if (!targetLayer) continue;
+      const allowed = config.allowedDependencies[layer] ?? [];
+      if (!allowed.includes(targetLayer)) {
+        errors.push(`${relative}: ${layer} cannot import ${targetLayer} module ${specifier}`);
+      }
+    }
+  }
+
+  return { ok: errors.length === 0, errors, files: files.length, layers: counts };
+}
+
+function main(argv = process.argv.slice(2)) {
+  const json = argv.includes("--json");
+  const unknown = argv.filter((argument) => argument !== "--json");
+  if (unknown.length > 0) {
+    process.stderr.write(`FAIL: unknown option ${unknown[0]}\n`);
+    return 1;
+  }
+  let result;
+  try {
+    result = inspectArchitecture();
+  } catch (error) {
+    process.stderr.write(`FAIL: ${error instanceof Error ? error.message : String(error)}\n`);
+    return 1;
+  }
+  if (!result.ok) {
+    process.stderr.write(`FAIL: architecture 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.files} source files respect architecture boundaries and line budgets\n`);
+  return 0;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  process.exit(main());
+}
+
+export { inspectArchitecture, layerFor, main, readConfig, sourceLineCount };

package/scripts/check-doc-languages.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const manifestPath = path.join(repoRoot, "docs", "languages.json");
+
+function markdownRelativeLink(from, to) {
+  const relative = path.relative(path.dirname(from), to).split(path.sep).join("/");
+  return relative.startsWith(".") ? relative : `./${relative}`;
+}
+
+function inspectDocLanguages(root = repoRoot) {
+  const manifestFile = path.join(root, "docs", "languages.json");
+  const manifest = JSON.parse(fs.readFileSync(manifestFile, "utf8"));
+  if (manifest?.schemaVersion !== 1 || !Array.isArray(manifest.pairs)) {
+    throw new Error("docs/languages.json has an unsupported schema");
+  }
+  const errors = [];
+  const topics = new Set();
+  for (const pair of manifest.pairs) {
+    if (!pair.topic || topics.has(pair.topic)) errors.push(`duplicate or missing topic: ${pair.topic ?? "unknown"}`);
+    topics.add(pair.topic);
+    const en = path.join(root, pair.en);
+    const vi = path.join(root, pair.vi);
+    if (!fs.existsSync(en)) errors.push(`${pair.topic}: missing English file ${pair.en}`);
+    if (!fs.existsSync(vi)) errors.push(`${pair.topic}: missing Vietnamese file ${pair.vi}`);
+    if (!fs.existsSync(en) || !fs.existsSync(vi)) continue;
+    const enText = fs.readFileSync(en, "utf8");
+    const viText = fs.readFileSync(vi, "utf8");
+    const viLink = markdownRelativeLink(en, vi).replace(/^\.\//, "");
+    const enLink = markdownRelativeLink(vi, en).replace(/^\.\//, "");
+    if (!enText.includes(viLink)) errors.push(`${pair.topic}: English file does not link to ${viLink}`);
+    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 };
+}
+
+function main(argv = process.argv.slice(2)) {
+  const json = argv.includes("--json");
+  const unknown = argv.filter((argument) => argument !== "--json");
+  if (unknown.length > 0) {
+    process.stderr.write(`FAIL: unknown option ${unknown[0]}\n`);
+    return 1;
+  }
+  let result;
+  try {
+    result = inspectDocLanguages();
+  } catch (error) {
+    process.stderr.write(`FAIL: ${error instanceof Error ? error.message : String(error)}\n`);
+    return 1;
+  }
+  if (!result.ok) {
+    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`);
+  return 0;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  process.exit(main());
+}
+
+export { inspectDocLanguages, main, markdownRelativeLink };

package/scripts/verify-local.sh

@@ -34,6 +34,7 @@ done
 
 required_files=(
   "$ROOT/README.md"
+  "$ROOT/README.vi.md"
   "$ROOT/SECURITY.md"
   "$ROOT/AGENTS.md"
   "$ROOT/CHANGELOG.md"
@@ -51,6 +52,22 @@ required_files=(
   "$ROOT/.pi/project-context.md"
   "$ROOT/packages/piagent-core/package.json"
   "$ROOT/packages/piagent-core/extensions/piagent-guard.ts"
+  "$ROOT/packages/piagent-core/runtime/runtime-limits.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/agent-start-hook.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/completion-hook.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/input-hook.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/session-hooks.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/session-start-hook.ts"
+  "$ROOT/packages/piagent-core/runtime/hooks/tool-result-hook.ts"
+  "$ROOT/packages/piagent-core/runtime/input/chat-images.ts"
+  "$ROOT/packages/piagent-core/runtime/session/message-signals.ts"
+  "$ROOT/packages/piagent-core/runtime/session/runtime-state.ts"
+  "$ROOT/packages/piagent-core/runtime/session/system-prompt.ts"
+  "$ROOT/packages/piagent-core/runtime/session/tool-result-compaction.ts"
+  "$ROOT/packages/piagent-core/runtime/session/usage.ts"
+  "$ROOT/packages/piagent-core/runtime/tools/tool-groups.ts"
+  "$ROOT/packages/piagent-core/runtime/workflows/input-routing.ts"
+  "$ROOT/packages/piagent-core/runtime/workflows/task-intake.ts"
   "$ROOT/packages/piagent-core/extensions/context-engine.js"
   "$ROOT/packages/piagent-core/extensions/context-index-policy.js"
   "$ROOT/packages/piagent-core/extensions/local-state-path.js"
@@ -104,6 +121,14 @@ required_files=(
   "$ROOT/templates/project/.pi/gitignore.template"
   "$ROOT/templates/project/REVIEW_GUIDELINES.md"
   "$ROOT/docs/quickstart-vietnamese.md"
+  "$ROOT/docs/README.md"
+  "$ROOT/docs/languages.json"
+  "$ROOT/docs/en/README.md"
+  "$ROOT/docs/en/architecture.md"
+  "$ROOT/docs/en/maintainer-guide.md"
+  "$ROOT/docs/vi/README.md"
+  "$ROOT/docs/vi/architecture.md"
+  "$ROOT/docs/vi/maintainer-guide.md"
   "$ROOT/docs/command-reference-vietnamese.md"
   "$ROOT/docs/auto-delegation-policy.md"
   "$ROOT/docs/subagent-orchestration-capabilities.md"
@@ -138,6 +163,9 @@ required_files=(
   "$ROOT/docs-site/content/mcp.html"
   "$ROOT/docs-site/vercel.json"
   "$ROOT/scripts/build-docs-site.mjs"
+  "$ROOT/scripts/check-architecture.mjs"
+  "$ROOT/scripts/check-doc-languages.mjs"
+  "$ROOT/architecture/layers.json"
   "$ROOT/scripts/context-engine.mjs"
   "$ROOT/scripts/preview-docs-site.mjs"
   "$ROOT/schemas/project-profile.schema.json"
@@ -553,6 +581,7 @@ if grep -R -E -i \
   "$ROOT/packages/piagent-core/prompts" \
   "$ROOT/packages/piagent-core/mcp" \
   "$ROOT/packages/piagent-core/extensions" \
+  "$ROOT/packages/piagent-core/runtime" \
   "$ROOT/templates/project/AGENTS.md" >/dev/null; then
   echo "Public docs contain non-neutral platform wording"
   exit 1
@@ -582,6 +611,8 @@ node --check "$ROOT/scripts/check-runtime-advisories.mjs" >/dev/null
 node --check "$ROOT/scripts/check-published-site.mjs" >/dev/null
 node --check "$ROOT/scripts/build-docs-site.mjs" >/dev/null
 node --check "$ROOT/scripts/preview-docs-site.mjs" >/dev/null
+node "$ROOT/scripts/check-architecture.mjs" >/dev/null
+node "$ROOT/scripts/check-doc-languages.mjs" >/dev/null
 run_quietly "npm test" npm test
 if [[ -x "$ROOT/node_modules/.bin/tsc" ]]; then
   run_quietly "npm run typecheck" npm run typecheck