@rosetears/aili-pi 0.1.0 → 0.1.3

package/extensions/zentui/user-message.ts

@@ -0,0 +1,252 @@
+import { type Theme, type ThemeColor, UserMessageComponent } from "@earendil-works/pi-coding-agent";
+import {
+	Markdown,
+	type MarkdownTheme,
+	truncateToWidth,
+	visibleWidth,
+} from "@earendil-works/pi-tui";
+import type { PolishedTuiConfig } from "./config.js";
+import { installPrototypePatch } from "./prototype-patch-registry.js";
+import {
+	EDITOR_ACCENT_FALLBACK,
+	renderStyleForSourceOrFallback,
+} from "./style.js";
+import { renderEditorFrameBorder } from "./ui.js";
+
+const OSC133_ZONE_START = "\x1b]133;A\x07";
+const OSC133_ZONE_END = "\x1b]133;B\x07";
+const OSC133_ZONE_FINAL = "\x1b]133;C\x07";
+
+type PatchableUserMessagePrototype = {
+	children?: unknown[];
+};
+
+type Cleanup = () => void;
+
+type UserMessageRenderCache = {
+	hasMarkdownText: boolean;
+	text?: string;
+	width?: number;
+	theme?: Theme;
+	configKey?: string;
+	renderedLines?: string[];
+};
+
+const userMessageRenderCache = new WeakMap<object, UserMessageRenderCache>();
+
+function isObject(value: unknown): value is object {
+	return (typeof value === "object" && value !== null) || typeof value === "function";
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function findMarkdownText(value: unknown): string | undefined {
+	if (!isRecord(value)) return undefined;
+	if (typeof value.text === "string") return value.text;
+
+	const children = value.children;
+	if (!Array.isArray(children)) return undefined;
+
+	for (const child of children) {
+		const text = findMarkdownText(child);
+		if (text !== undefined) return text;
+	}
+
+	return undefined;
+}
+
+function getCachedMarkdownText(instance: object): string | undefined {
+	const cached = userMessageRenderCache.get(instance);
+	if (cached?.hasMarkdownText) return cached.text;
+
+	const text = findMarkdownText(instance);
+	if (text !== undefined) {
+		userMessageRenderCache.set(instance, { ...cached, hasMarkdownText: true, text });
+	}
+	return text;
+}
+
+function getUserMessageConfigKey(config: PolishedTuiConfig): string {
+	return [
+		config.features.copyFriendly ? "copy" : "chrome",
+		config.colorSources.userMessages,
+		config.colors.editorAccent ?? "",
+		config.colors.editorBorder ?? "",
+		config.icons.rail,
+	].join("\0");
+}
+
+function themeFg(theme: Theme | undefined, color: ThemeColor, text: string): string {
+	if (!theme) return text;
+	try {
+		return theme.fg(color, text);
+	} catch {
+		return text;
+	}
+}
+
+function makeMarkdownTheme(theme: Theme | undefined): MarkdownTheme {
+	return {
+		heading: (text) => themeFg(theme, "mdHeading", text),
+		link: (text) => themeFg(theme, "mdLink", text),
+		linkUrl: (text) => themeFg(theme, "mdLinkUrl", text),
+		code: (text) => themeFg(theme, "mdCode", text),
+		codeBlock: (text) => themeFg(theme, "mdCodeBlock", text),
+		codeBlockBorder: (text) => themeFg(theme, "mdCodeBlockBorder", text),
+		quote: (text) => themeFg(theme, "mdQuote", text),
+		quoteBorder: (text) => themeFg(theme, "mdQuoteBorder", text),
+		hr: (text) => themeFg(theme, "mdHr", text),
+		listBullet: (text) => themeFg(theme, "mdListBullet", text),
+		bold: (text) => (theme ? theme.bold(text) : text),
+		italic: (text) => (theme ? theme.italic(text) : text),
+		underline: (text) => (theme ? theme.underline(text) : text),
+		strikethrough: (text) => (theme ? theme.strikethrough(text) : text),
+	};
+}
+
+function fillLine(content: string, width: number): string {
+	const truncated = truncateToWidth(content, Math.max(0, width), "");
+	const pad = " ".repeat(Math.max(0, width - visibleWidth(truncated)));
+	return `${truncated}${pad}`;
+}
+
+function renderPromptBoxRail(theme: Theme | undefined, config: PolishedTuiConfig): string {
+	if (config.features.copyFriendly) return "";
+	const railGlyph = config.icons.rail;
+
+	return `${
+		theme
+			? renderStyleForSourceOrFallback(
+					theme,
+					config.colorSources.userMessages,
+					config.colors.editorAccent,
+					EDITOR_ACCENT_FALLBACK,
+					railGlyph,
+				)
+			: railGlyph
+	} `;
+}
+
+function renderPromptBoxLine(
+	line: string,
+	width: number,
+	theme: Theme | undefined,
+	config: PolishedTuiConfig,
+): string {
+	if (width <= 0) return "";
+	const rail = renderPromptBoxRail(theme, config);
+	const contentWidth = Math.max(0, width - visibleWidth(rail));
+	const content = config.features.copyFriendly
+		? truncateToWidth(line, contentWidth, "")
+		: fillLine(line, contentWidth);
+	return truncateToWidth(`${rail}${content}`, width, "");
+}
+
+function renderZentuiUserMessage(
+	instance: PatchableUserMessagePrototype,
+	width: number,
+	theme: Theme | undefined,
+	config: PolishedTuiConfig,
+): string[] | undefined {
+	if (!isRecord(instance)) return undefined;
+
+	const text = getCachedMarkdownText(instance);
+	if (text === undefined) return undefined;
+	if (width <= 0) return [""];
+
+	const configKey = getUserMessageConfigKey(config);
+	const cached = userMessageRenderCache.get(instance);
+	if (
+		cached?.hasMarkdownText &&
+		cached.width === width &&
+		cached.theme === theme &&
+		cached.configKey === configKey &&
+		cached.renderedLines
+	) {
+		return cached.renderedLines;
+	}
+
+	const railWidth = visibleWidth(renderPromptBoxRail(theme, config));
+	const contentWidth = Math.max(1, width - railWidth);
+	const renderer = new Markdown(text, 0, 0, makeMarkdownTheme(theme), {
+		color: (content) => themeFg(theme, "userMessageText", content),
+	});
+	const body = renderer.render(contentWidth);
+	const contentLines = body.length > 0 ? body : [""];
+	const border = theme
+		? renderEditorFrameBorder(
+				"─".repeat(width),
+				config,
+				theme,
+				config.colorSources.userMessages,
+			)
+		: "─".repeat(width);
+	const lines = [
+		truncateToWidth(border, width, ""),
+		renderPromptBoxLine("", width, theme, config),
+		...contentLines.map((line) => renderPromptBoxLine(line, width, theme, config)),
+		renderPromptBoxLine("", width, theme, config),
+		truncateToWidth(border, width, ""),
+	];
+
+	userMessageRenderCache.set(instance, {
+		hasMarkdownText: true,
+		text,
+		width,
+		theme,
+		configKey,
+		renderedLines: lines,
+	});
+	return lines;
+}
+
+function withPromptZoneMarkers(lines: string[]): string[] {
+	const markedLines = [...lines];
+	markedLines[0] = OSC133_ZONE_START + markedLines[0];
+	markedLines[markedLines.length - 1] =
+		OSC133_ZONE_END + OSC133_ZONE_FINAL + markedLines[markedLines.length - 1];
+	return markedLines;
+}
+
+export function installUserMessageStyle(
+	getTheme: () => Theme | undefined,
+	getConfig: () => PolishedTuiConfig,
+): Cleanup {
+	const prototype = UserMessageComponent.prototype;
+	const cleanupInvalidate = installPrototypePatch(
+		prototype,
+		"invalidate",
+		"user-message-invalidate",
+		({ predecessor, receiver, args }) => {
+			if (isObject(receiver)) userMessageRenderCache.delete(receiver);
+			return Reflect.apply(predecessor, receiver, args);
+		},
+	);
+	const cleanupRender = installPrototypePatch(
+		prototype,
+		"render",
+		"user-message-render",
+		({ predecessor, receiver, args }) => {
+			const width = args[0];
+			if (typeof width !== "number") return Reflect.apply(predecessor, receiver, args);
+			const lines = renderZentuiUserMessage(
+				receiver as PatchableUserMessagePrototype,
+				width,
+				getTheme(),
+				getConfig(),
+			);
+			if (!lines) return Reflect.apply(predecessor, receiver, args);
+			if (lines.length === 0) return lines;
+			return withPromptZoneMarkers(lines);
+		},
+	);
+	let cleaned = false;
+	return () => {
+		if (cleaned) return;
+		cleaned = true;
+		cleanupRender();
+		cleanupInvalidate();
+	};
+}

package/licenses/pi-sakura-cyberdeck-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pi-sakura-cyberdeck contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/licenses/pi-zentui-MIT.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Luka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/manifests/capabilities.json

@@ -35,7 +35,7 @@
     {
       "id": "subagent.dispatch",
       "provider": "@agwab/pi-subagent",
-      "adapterOwner": "aili thin policy adapter over @agwab/pi-subagent/api@0.4.8",
+      "adapterOwner": "aili generic wrapper over @agwab/pi-subagent@0.4.8 with mandatory credential guard",
       "platforms": ["linux"],
       "class": "required",
       "risk": { "secret": "possible", "network": "provider-dependent", "sideEffect": "delegated" },

package/manifests/live-verification.json

@@ -3,24 +3,30 @@
   "platform": "linux",
   "piVersion": "0.81.1",
   "status": "passed",
-  "approvedScope": "fresh code-scout child; read-only package.json boundary; no project mutation; four separately approved provider attempts, with the latest passing after legacy permission-runtime removal refreshed the adapter binding",
+  "approvedScope": "generic agentless headless child; read-only package.json boundary; no business-file mutation, bash, worktree, sandbox, external cwd, or global-home access; only approved temporary run artifacts were created and removed",
   "probes": [
     {
-      "id": "native-subagent-api-fixture",
-      "command": "npx vitest run tests/unit/subagents.test.ts",
+      "id": "generic-subagent-fixtures",
+      "command": "npx vitest run tests/unit/subagents.test.ts tests/integration/generic-subagent.test.ts",
       "status": "passed"
     },
     {
-      "id": "code-scout-read-package",
-      "command": "AILI_LIVE_SUBAGENT_PROBE=1 npx vitest run tests/integration/live-subagent.test.ts",
+      "id": "generic-agentless-read-package",
+      "command": "AILI_LIVE_GENERIC_SUBAGENT_PROBE=1 npx vitest run tests/integration/live-subagent.test.ts",
+      "status": "passed",
+      "changedFiles": 0
+    },
+    {
+      "id": "generic-credential-guard",
+      "command": "AILI_LIVE_CREDENTIAL_GUARD_PROBE=1 npx vitest run tests/integration/live-subagent.test.ts",
       "status": "passed",
       "changedFiles": 0
     }
   ],
   "implementation": {
-    "src/runtime/subagents.ts": "260429148e4b15db5a3dcc470d22c2661ffc7037de28bb227ba68262ec8be88c",
-    "tests/unit/subagents.test.ts": "48691168ca18e6a7038590a1ec348927e2328ed2009f0129138aef2dec715dcd",
-    "tests/integration/live-subagent.test.ts": "8ca54fafe77b8a58c36207ac0f72340188a70ce125871a6630cdb2b934629fd5"
+    "src/runtime/subagents.ts": "b33e0ab1dba44212ada389fcca98774d98220396ead94951dee073df54784b0a",
+    "tests/unit/subagents.test.ts": "6ae824df46b3ae5b8744bcdef144372281cfca7a4b752ac26fd2d70f0b6cdc6c",
+    "tests/integration/live-subagent.test.ts": "46a907526890c4cd4a4e1d768fca51173c9a0c3db37ac83ba57db23d54d7f339"
   },
   "credentialHandling": "Existing Pi authentication was used by Pi; AILI did not copy, print, or modify authentication files."
 }

package/manifests/provenance.json

@@ -10,14 +10,16 @@
       "status": "adapted",
       "sourceFiles": [
         "upstream/aili-workflows.lock.json#files (471 exact skill files)",
-        "manifests/roles.json#records[].sourcePath (19 exact role source files)"
+        "manifests/roles.json#records[].sourcePath (19 exact role source files)",
+        "upstream/opencode-global-agents.lock.json (pinned source template revision/hash)"
       ],
       "symbols": ["64 canonical skill bodies and owned assets", "19 child-role prompt bodies"],
       "localChanges": [
         "skills/** is an exact byte-for-byte snapshot with no semantic overlay",
-        "role prompts are generated as Pi frontmatter with explicit tool/capability ceilings and structured output"
+        "role prompts are generated as Pi frontmatter with explicit tool/capability ceilings and structured output",
+        "templates/APPEND_SYSTEM.md is a Pi-native governance derivation of the pinned global AGENTS template, with OpenCode-only control planes excluded"
       ],
-      "verification": ["npm run verify:skills", "npm run verify:roles"]
+      "verification": ["npm run verify:skills", "npm run verify:roles", "tests/unit/global-resources.test.ts"]
     },
     {
       "name": "@agwab/pi-subagent",
@@ -28,8 +30,8 @@
       "status": "dependency",
       "sourceFiles": ["src/api.ts", "src/runners/headless-model.ts", "src/artifacts/result.ts"],
       "symbols": ["runSubagent API", "headless lifecycle", "artifact envelope"],
-      "localChanges": ["AILI calls the pinned API through a thin role/path/tool policy adapter; no upstream source is copied"],
-      "verification": ["tests/unit/subagents.test.ts", "tests/integration/extension-load.test.ts"]
+      "localChanges": ["AILI registers the full pinned upstream subagent tool schema, injects a non-removable credential guard, and relies on the ambient AILI pi-permission-modes registration exactly once in each child; no upstream source is copied"],
+      "verification": ["tests/unit/subagents.test.ts", "tests/integration/package-runtime.test.ts"]
     },
     {
       "name": "pi-permission-modes",
@@ -66,6 +68,17 @@
       "symbols": ["web_search", "fetch_content", "get_search_content", "curator and bundled librarian skill"],
       "localChanges": ["AILI initializes the complete pinned upstream surface through its sole Extension entry; no upstream source is copied"],
       "verification": ["tests/unit/runtime.test.ts", "tests/integration/extension-load.test.ts"]
+    },
+    {
+      "name": "pi-sakura-cyberdeck",
+      "repository": "https://github.com/beautifulrem/pi-sakura-cyberdeck.git",
+      "revision": "165a1f8011a12a58a6409b56b8a6c0416cd9b589",
+      "license": "MIT",
+      "status": "adapted",
+      "sourceFiles": ["extensions/header/index.ts", "extensions/matrix/index.ts", "extensions/zentui/**"],
+      "symbols": ["header", "matrix animation", "Zentui footer", "fixed editor compositor"],
+      "localChanges": ["registered as three additional Pi Package Extensions", "header avatar loads the supplied Rem asset", "Sakura palette values are replaced with the Rem palette", "relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"],
+      "verification": ["npm run typecheck", "npm test", "npm pack --dry-run --json"]
     }
   ]
 }

package/manifests/sbom.json

@@ -3,7 +3,7 @@
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
   "name": "@rosetears/aili-pi-0.0.0-development",
-  "documentNamespace": "https://github.com/Rosetears520/aili-pi/sbom/0dc68f85cf885dfe4aaa2cc637c4c01d",
+  "documentNamespace": "https://github.com/Rosetears520/aili-pi/sbom/4326541e956e5e266160f3dab73372d5",
   "creationInfo": {
     "creators": [
       "Tool: @rosetears/aili-pi scripts/generate-provenance.ts"
@@ -31,7 +31,7 @@
       "licenseDeclared": "MIT",
       "checksums": [],
       "primaryPackagePurpose": "SOURCE",
-      "comment": "revision=7eb35f357ad489f5841ee10dac1e44549c1bdb76; files=upstream/aili-workflows.lock.json#files (471 exact skill files), manifests/roles.json#records[].sourcePath (19 exact role source files); symbols=64 canonical skill bodies and owned assets, 19 child-role prompt bodies; local changes=skills/** is an exact byte-for-byte snapshot with no semantic overlay | role prompts are generated as Pi frontmatter with explicit tool/capability ceilings and structured output"
+      "comment": "revision=7eb35f357ad489f5841ee10dac1e44549c1bdb76; files=upstream/aili-workflows.lock.json#files (471 exact skill files), manifests/roles.json#records[].sourcePath (19 exact role source files), upstream/opencode-global-agents.lock.json (pinned source template revision/hash); symbols=64 canonical skill bodies and owned assets, 19 child-role prompt bodies; local changes=skills/** is an exact byte-for-byte snapshot with no semantic overlay | role prompts are generated as Pi frontmatter with explicit tool/capability ceilings and structured output | templates/APPEND_SYSTEM.md is a Pi-native governance derivation of the pinned global AGENTS template, with OpenCode-only control planes excluded"
     },
     {
       "SPDXID": "SPDXRef-source-agwab-pi-subagent-7cd9ea345a",
@@ -43,7 +43,7 @@
       "licenseDeclared": "MIT",
       "checksums": [],
       "primaryPackagePurpose": "SOURCE",
-      "comment": "revision=daa7b83819116a62008ad17aa65fcd50fefbafd0; files=src/api.ts, src/runners/headless-model.ts, src/artifacts/result.ts; symbols=runSubagent API, headless lifecycle, artifact envelope; local changes=AILI calls the pinned API through a thin role/path/tool policy adapter; no upstream source is copied"
+      "comment": "revision=daa7b83819116a62008ad17aa65fcd50fefbafd0; files=src/api.ts, src/runners/headless-model.ts, src/artifacts/result.ts; symbols=runSubagent API, headless lifecycle, artifact envelope; local changes=AILI registers the full pinned upstream subagent tool schema, injects a non-removable credential guard, and relies on the ambient AILI pi-permission-modes registration exactly once in each child; no upstream source is copied"
     },
     {
       "SPDXID": "SPDXRef-source-pi-permission-modes-9b38b384cd",
@@ -81,6 +81,17 @@
       "primaryPackagePurpose": "SOURCE",
       "comment": "revision=npm:0.13.0; files=index.ts, skills/; symbols=web_search, fetch_content, get_search_content, curator and bundled librarian skill; local changes=AILI initializes the complete pinned upstream surface through its sole Extension entry; no upstream source is copied"
     },
+    {
+      "SPDXID": "SPDXRef-source-pi-sakura-cyberdeck-7125826ba0",
+      "name": "pi-sakura-cyberdeck",
+      "downloadLocation": "https://github.com/beautifulrem/pi-sakura-cyberdeck/commit/165a1f8011a12a58a6409b56b8a6c0416cd9b589",
+      "filesAnalyzed": false,
+      "licenseConcluded": "MIT",
+      "licenseDeclared": "MIT",
+      "checksums": [],
+      "primaryPackagePurpose": "SOURCE",
+      "comment": "revision=165a1f8011a12a58a6409b56b8a6c0416cd9b589; files=extensions/header/index.ts, extensions/matrix/index.ts, extensions/zentui/**; symbols=header, matrix animation, Zentui footer, fixed editor compositor; local changes=registered as three additional Pi Package Extensions | header avatar loads the supplied Rem asset | Sakura palette values are replaced with the Rem palette | relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"
+    },
     {
       "SPDXID": "SPDXRef-node-modules-agent-base-e28bede7a2",
       "name": "agent-base",
@@ -6043,6 +6054,11 @@
       "relationshipType": "DEPENDS_ON",
       "relatedSpdxElement": "SPDXRef-source-pi-web-access-7a2e6bb486"
     },
+    {
+      "spdxElementId": "SPDXRef-Package-aili-pi",
+      "relationshipType": "DEPENDS_ON",
+      "relatedSpdxElement": "SPDXRef-source-pi-sakura-cyberdeck-7125826ba0"
+    },
     {
       "spdxElementId": "SPDXRef-Package-aili-pi",
       "relationshipType": "DEPENDS_ON",

package/notices/pi-sakura-cyberdeck-NOTICE.txt

@@ -0,0 +1,6 @@
+This package includes a modified copy of pi-zentui by Luka.
+Original project: https://github.com/lmilojevicc/pi-zentui
+License: MIT. Full license text: licenses/pi-zentui-MIT.txt
+
+Modifications include the Sakura Macaron palette, truecolor gradient editor
+chrome, package-specific defaults, and package-specific configuration path.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosetears/aili-pi",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "AILI and ROSE distribution for official Pi",
   "type": "module",
   "license": "MIT",
@@ -23,18 +23,23 @@
     "manifests/",
     "upstream/",
     "scripts/",
+    "themes/",
     "templates/",
     "install.sh",
+    "licenses/",
+    "notices/",
     "README.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md"
   ],
   "pi": {
     "extensions": [
-      "./extensions/index.ts"
+      "./extensions/index.ts",
+      "./extensions/header/index.ts",
+      "./extensions/matrix/index.ts",
+      "./extensions/zentui/index.ts"
     ],
     "skills": [
-      "./skills",
       "./node_modules/pi-web-access/skills"
     ],
     "prompts": [
@@ -43,12 +48,16 @@
       "./prompts/build.md",
       "./prompts/ship.md",
       "./prompts/local-review.md"
+    ],
+    "themes": [
+      "./themes/rem-cyberdeck.json"
     ]
   },
   "engines": {
     "node": ">=22.19.0"
   },
   "scripts": {
+    "postinstall": "node scripts/sync-global-skills.mjs --if-pi-managed",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "sync:skills": "node --experimental-strip-types scripts/sync-skills.ts",

package/scripts/local-package-e2e.ts

@@ -43,7 +43,7 @@ if (!installed.includes(packageRoot)) throw new Error("Pi list did not report th
 const smoke = await run(pi, ["--list-models"], environment);
 if (smoke.includes("Failed to load extension")) throw new Error("installed Package failed Extension loading");
 const packageJson = JSON.parse(await readFile(join(packageRoot, "package.json"), "utf8")) as { pi?: { extensions?: string[]; prompts?: string[]; skills?: string[] } };
-if (packageJson.pi?.extensions?.length !== 1 || packageJson.pi?.prompts?.length !== 5 || packageJson.pi?.skills?.length !== 2 || !packageJson.pi.skills.includes("./node_modules/pi-web-access/skills")) throw new Error("packed resource declarations are incomplete");
+if (packageJson.pi?.extensions?.length !== 4 || packageJson.pi?.prompts?.length !== 5 || packageJson.pi?.skills?.length !== 1 || packageJson.pi.skills[0] !== "./node_modules/pi-web-access/skills") throw new Error("packed resource declarations are incomplete");
 await run(pi, ["remove", packageRoot], environment);
 const removed = await run(pi, ["list"], environment);
 if (!removed.includes("No packages installed")) throw new Error("Pi Package removal did not reconcile settings");

package/scripts/sync-global-skills.d.mts

@@ -0,0 +1,13 @@
+export type GlobalSkillSyncReport = {
+  scanned: number;
+  updated: string[];
+  skippedMissing: string[];
+  skippedUnsafe: string[];
+};
+
+export function isPiManagedNpmPackageRoot(packageRoot: string, home?: string): boolean;
+
+export function syncExistingGlobalSkills(options?: {
+  packageRoot?: string;
+  home?: string;
+}): Promise<GlobalSkillSyncReport>;