@piagent/platform 1.2.12 → 1.2.14

package/docs-site/team.html

@@ -27,7 +27,8 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.14 docs · VI</span>
+        <a class="button" href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/README.md" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" 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" />
@@ -74,6 +75,7 @@
             <a class="nav-link" href="/security">Security model</a>
             <a class="nav-link" href="/architecture">Architecture</a>
             <a class="nav-link" href="/context-engine">Context Engine</a>
+            <a class="nav-link" href="/benchmark">Benchmark</a>
             <a class="nav-link" href="/runtime">Runtime tools</a>
             <a class="nav-link current" href="/team" aria-current="page">Team usage</a>
           </div>
@@ -128,6 +130,7 @@
               <div class="footer-links" aria-label="External links">
                 <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
                 <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
+                <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/README.md" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
                 <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
               </div>
             </footer>

package/docs-site/workflows.html

@@ -27,7 +27,8 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.14 docs · VI</span>
+        <a class="button" href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/README.md" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" 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" />
@@ -74,6 +75,7 @@
             <a class="nav-link" href="/security">Security model</a>
             <a class="nav-link" href="/architecture">Architecture</a>
             <a class="nav-link" href="/context-engine">Context Engine</a>
+            <a class="nav-link" href="/benchmark">Benchmark</a>
             <a class="nav-link" href="/runtime">Runtime tools</a>
             <a class="nav-link" href="/team">Team usage</a>
           </div>
@@ -156,6 +158,7 @@
               <div class="footer-links" aria-label="External links">
                 <a href="https://piagent.io.vn" target="_blank" rel="noopener noreferrer">piagent.io.vn</a>
                 <a href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer">GitHub repository</a>
+                <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/README.md" lang="en" target="_blank" rel="noopener noreferrer">English docs</a>
                 <a href="https://www.facebook.com/vinhtam0544/" target="_blank" rel="noopener noreferrer">Facebook profile</a>
               </div>
             </footer>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/platform",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
@@ -27,7 +27,9 @@
     "CONTRIBUTING.md",
     "LICENSE",
     "README.md",
+    "README.vi.md",
     "SECURITY.md",
+    "architecture/",
     ".gitattributes",
     "adapters/",
     "benchmarks/",
@@ -122,6 +124,8 @@
     "site:build": "node scripts/build-docs-site.mjs",
     "site:preview": "node scripts/preview-docs-site.mjs",
     "site:check": "node scripts/check-published-site.mjs",
+    "architecture:check": "node scripts/check-architecture.mjs",
+    "docs:check": "node scripts/check-doc-languages.mjs",
     "smoke": "bash scripts/runtime-policy-smoke.sh",
     "usage": "bash scripts/pi-session-stats.sh",
     "auto": "bash scripts/pi-auto.sh",

package/packages/piagent-core/README.md

@@ -4,7 +4,9 @@ Shared Pi package for reusable project workflows.
 
 ## Contents
 
-- `extensions/piagent-guard.ts`: runtime guard tools and policy hooks.
+- `extensions/piagent-guard.ts`: Pi extension composition root and registration order.
+- `runtime/`: Pi-facing session, usage, log-compaction, and workflow input adapters. New command/tool/hook modules belong here.
+- `extensions/*.js|ts`: legacy-location core services for policy, context, task lifecycle, state, and document intake; only `piagent-guard.ts` is loaded as an extension.
 - `prompts/*.md`: workflow aliases that intentionally launch an agent turn.
 - `skills/piagent-ops/SKILL.md`: operator-invoked reference for manual intake, recovery, and high-risk controls; routine runtime-managed tasks do not advertise or load it.
 - `skills/piagent-source-cache/`: local cache for user-provided external source repositories.
@@ -15,6 +17,8 @@ Shared Pi package for reusable project workflows.
 - compact tool-result rendering: oversized redacted output is previewed in Pi and captured under `.pi/piagent-state/tool-results/` for offline audit/reporting.
 - local Context Engine v2: incremental FTS5/symbol/import index, hybrid retrieval, token-budgeted packs, bounded current-turn source/test snapshots, test-impact mapping, dynamic Piagent tools, and Agent Watch compatible telemetry.
 
+Architecture boundaries and non-growth file budgets are enforced by `npm run architecture:check`. See [English architecture](../../docs/en/architecture.md), [kiến trúc tiếng Việt](../../docs/vi/architecture.md), and the paired maintainer guides before adding a new runtime surface.
+
 The root package exposes `piagent-benchmark` for an automatic paired Piagent
 steady-state benchmark against Raw Pi or the `codex-cli` surface. Treatment
 onboarding/context preparation happens before measured model usage;
@@ -99,7 +103,7 @@ groups load only when requested.
 - `/commands`: runtime menu/help for terminal, Pi, MCP, model, memory, session, context, permission, and subagent commands.
 - `/workflow`: one launcher for task, scout, BE-to-FE, discuss, plan, review, commit, PR, platform-improve, and onboarding workflows.
 - `/usage`: runtime usage namespace for live snapshot, history hint, preflight, compact, compact-log captures, and context efficiency.
-- `/name`: set the current session name for Agent Watch/report mapping.
+- Pi native `/name`: set the current session name for Agent Watch/report mapping; Piagent observes the native rename event and keeps `/setname` as a compatibility alias.
 - `/fresh`: open a fresh governed session for `task`, `scout`, or `be-to-fe`.
 - `/context`: runtime context namespace for index/rebuild/search/pack/test-impact/efficiency, task preflight, and semantic compact.
 - `/permission`: runtime permission namespace for status/read-only/workspace-write/full-access.

package/packages/piagent-core/capabilities/capability-core.js

@@ -3,6 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { containsSensitiveText } from "../security/sensitive-data.js";
 import { resolveProjectProfileDocument } from "./project-profile.js";
+import { CORE_RUNTIME_INTEGRITY_FILES } from "./runtime-integrity.js";
 
 const API_VERSION = "piagent/v1";
 const CORE_API_VERSION = 1;
@@ -788,6 +789,7 @@ function buildCoreIntegrity(root) {
     "packages/piagent-core/package.json",
     "packages/piagent-core/policies/base-policy.json",
     "packages/piagent-core/capabilities/capability-core.js",
+    "packages/piagent-core/capabilities/runtime-integrity.js",
     // capability-sources.js decides which external trees become readable packs,
     // so tampering with it changes which code the profile can grant.
     "packages/piagent-core/capabilities/capability-sources.js",
@@ -796,6 +798,7 @@ function buildCoreIntegrity(root) {
     "packages/piagent-core/capabilities/project-profile.js",
     "packages/piagent-core/security/sensitive-data.js",
     "packages/piagent-core/extensions/piagent-guard.ts",
+    ...CORE_RUNTIME_INTEGRITY_FILES,
     // context-engine.js decides which repository content enters the model
     // context and records the resulting telemetry, so it is part of the
     // runtime trust boundary enforced by the profile lock.

package/packages/piagent-core/capabilities/runtime-integrity.js

@@ -0,0 +1,18 @@
+export const CORE_RUNTIME_INTEGRITY_FILES = Object.freeze([
+  "packages/piagent-core/runtime/hooks/agent-start-hook.ts",
+  "packages/piagent-core/runtime/hooks/completion-hook.ts",
+  "packages/piagent-core/runtime/hooks/input-hook.ts",
+  "packages/piagent-core/runtime/hooks/session-hooks.ts",
+  "packages/piagent-core/runtime/hooks/session-start-hook.ts",
+  "packages/piagent-core/runtime/hooks/tool-result-hook.ts",
+  "packages/piagent-core/runtime/input/chat-images.ts",
+  "packages/piagent-core/runtime/runtime-limits.ts",
+  "packages/piagent-core/runtime/session/message-signals.ts",
+  "packages/piagent-core/runtime/session/runtime-state.ts",
+  "packages/piagent-core/runtime/session/system-prompt.ts",
+  "packages/piagent-core/runtime/session/tool-result-compaction.ts",
+  "packages/piagent-core/runtime/session/usage.ts",
+  "packages/piagent-core/runtime/tools/tool-groups.ts",
+  "packages/piagent-core/runtime/workflows/input-routing.ts",
+  "packages/piagent-core/runtime/workflows/task-intake.ts"
+]);

package/packages/piagent-core/extensions/guard-types.ts

@@ -391,43 +391,6 @@ export type EffectiveProtectedPaths = {
   readOnlyPaths: string[];
 };
 
-export type UsageSnapshot = {
-  sessionFile?: string;
-  sessionId?: string;
-  sessionName?: string;
-  cwd: string;
-  mode: string;
-  model: string;
-  thinkingLevel: string;
-  entries: {
-    total: number;
-    branch: number;
-  };
-  contextUsage?: {
-    tokens: number | null;
-    contextWindow: number;
-    percent: number | null;
-  };
-  exactTotals: {
-    availableInCommand: false;
-    howToRead: string[];
-  };
-};
-
-export type ContextPreflight = {
-  workflow: string;
-  inputChars: number;
-  inputTokenEstimate: number;
-  liveContext?: UsageSnapshot["contextUsage"];
-  projectedContext?: {
-    tokens: number;
-    percent: number;
-  };
-  recommendation: "ok" | "watch" | "compact" | "fresh-session" | "unknown";
-  reason: string;
-  commands: string[];
-};
-
 export type ReferenceRepo = {
   host: string;
   owner: string;