@agimon-ai/po-profile 0.0.0-alpha.0

package/dist/profileText-BkeG0Ulo.cjs

@@ -0,0 +1,292 @@
+let _agimon_ai_po_config_profiles = require("@agimon-ai/po-config/profiles");
+//#region src/constants/profileRuntime.ts
+const PROFILE_RUNTIME_SERVICE = "po/profile-runtime";
+//#endregion
+//#region src/services/profileRuntime/index.ts
+const UNAVAILABLE = "Profile integration provider is unavailable";
+const INVALIDATED = "Profile operation was invalidated";
+/** A single selected profile and provider, owned by one session, not a provider registry. */
+var SessionProfileRuntime = class {
+	options;
+	controller = new AbortController();
+	snapshot;
+	provider;
+	connection;
+	transition = Promise.resolve();
+	retirement = Promise.resolve();
+	pending = /* @__PURE__ */ new Set();
+	initializing = false;
+	disposed = false;
+	disposal;
+	constructor(options) {
+		this.options = options;
+		this.snapshot = this.capture(options.profileName, 1);
+	}
+	capture(profileName, generation) {
+		const binding = profileName === void 0 ? void 0 : this.options.readBinding(profileName);
+		return Object.freeze({
+			...profileName === void 0 ? {} : { profileName },
+			...binding === void 0 ? {} : { integration: (0, _agimon_ai_po_config_profiles.parseProfileBinding)(binding) },
+			generation,
+			signal: this.controller.signal
+		});
+	}
+	readSelection() {
+		return this.snapshot;
+	}
+	invalidate() {
+		this.controller.abort();
+		const connection = this.connection;
+		this.connection = void 0;
+		if (connection) {
+			this.retirement = this.retirement.then(async () => {
+				try {
+					await connection.dispose();
+				} catch {
+					throw new Error("Profile provider disposal failed");
+				}
+			});
+			this.track(this.retirement);
+		}
+	}
+	track(work) {
+		this.pending.add(work);
+		work.then(() => this.pending.delete(work), () => this.pending.delete(work));
+		return work;
+	}
+	initialize() {
+		const snapshot = this.snapshot;
+		const provider = this.provider;
+		this.initializing = Boolean(snapshot.integration && provider);
+		const work = (async () => {
+			await this.retirement;
+			if (snapshot.signal.aborted) return;
+			if (!snapshot.integration || !provider) return;
+			if (snapshot.integration.provider !== provider.name) throw new Error(UNAVAILABLE);
+			let connection;
+			try {
+				connection = await provider.factory(snapshot.integration, {
+					profileName: snapshot.profileName,
+					generation: snapshot.generation,
+					signal: snapshot.signal
+				});
+			} catch {
+				if (snapshot.signal.aborted) return;
+				throw new Error("Profile provider initialization failed");
+			}
+			if (snapshot.signal.aborted || this.snapshot !== snapshot || this.disposed) {
+				try {
+					await connection.dispose();
+				} catch {
+					throw new Error("Profile provider disposal failed");
+				}
+				return;
+			}
+			this.connection = connection;
+		})();
+		this.transition = this.track(work.finally(() => {
+			if (this.snapshot === snapshot) this.initializing = false;
+		}));
+		return this.transition;
+	}
+	async select(profileName) {
+		if (this.disposed) throw new Error(INVALIDATED);
+		if (this.snapshot.profileName === profileName && !this.snapshot.signal.aborted && (!this.snapshot.integration || !this.provider || this.connection || this.initializing)) return;
+		this.invalidate();
+		this.controller = new AbortController();
+		this.snapshot = this.capture(profileName, this.snapshot.generation + 1);
+		await this.initialize();
+	}
+	async ready() {
+		const snapshot = this.snapshot;
+		await this.transition;
+		if (this.disposed || snapshot.signal.aborted || this.snapshot !== snapshot) throw new Error(INVALIDATED);
+		if (snapshot.integration && !this.connection) throw new Error(UNAVAILABLE);
+	}
+	async attachProvider(providerName, factory) {
+		if (this.disposed || this.snapshot.signal.aborted) throw new Error(INVALIDATED);
+		if (this.provider) throw new Error("Profile provider is already attached");
+		if (this.snapshot.integration && this.snapshot.integration.provider !== providerName) throw new Error(UNAVAILABLE);
+		const provider = {
+			name: providerName,
+			factory
+		};
+		this.provider = provider;
+		try {
+			await this.initialize();
+			await this.ready();
+			if (this.disposed || this.provider !== provider) throw new Error(INVALIDATED);
+		} catch {
+			if (this.provider === provider) this.provider = void 0;
+			this.invalidate();
+			throw new Error("Profile provider initialization failed");
+		}
+		let detached = false;
+		return async () => {
+			if (detached || this.provider !== provider) return;
+			detached = true;
+			this.invalidate();
+			this.provider = void 0;
+			this.controller = new AbortController();
+			this.snapshot = Object.freeze({
+				...this.snapshot,
+				generation: this.snapshot.generation + 1,
+				signal: this.controller.signal
+			});
+			await this.retirement;
+		};
+	}
+	async resolveSecret(name, request) {
+		if (this.initializing) throw new Error("Profile secrets are unavailable during provider initialization");
+		await this.ready();
+		const snapshot = this.snapshot;
+		const connection = this.connection;
+		const reference = snapshot.integration?.secrets[name];
+		if (!connection || !reference || !Object.hasOwn(snapshot.integration.secrets, name)) throw new Error("Profile secret alias is unavailable");
+		if (!reference.allowedOrigins.includes(request.origin)) throw new Error("Profile secret origin is not allowed");
+		const signal = request.signal ? AbortSignal.any([snapshot.signal, request.signal]) : snapshot.signal;
+		if (signal.aborted) throw new Error(INVALIDATED);
+		let value;
+		try {
+			value = await connection.resolveSecret(reference, signal);
+		} catch {
+			throw new Error("Profile secret resolution failed");
+		}
+		if (signal.aborted || this.snapshot !== snapshot || this.connection !== connection) throw new Error(INVALIDATED);
+		if (typeof value !== "string" || value.length === 0) throw new Error("Profile secret field is unavailable");
+		return value;
+	}
+	dispose() {
+		if (this.disposal) return this.disposal;
+		this.disposed = true;
+		this.invalidate();
+		this.provider = void 0;
+		this.disposal = (async () => {
+			if ((await Promise.allSettled([...this.pending, this.retirement])).some((result) => result.status === "rejected")) throw new Error("Profile runtime disposal failed");
+		})();
+		return this.disposal;
+	}
+};
+function createProfileRuntime(options) {
+	return new SessionProfileRuntime(options);
+}
+/** Mounted in the scoped root services array, before dependent integration tools. */
+function createProfileRuntimePlugin(runtime) {
+	return (context) => {
+		context.provide(PROFILE_RUNTIME_SERVICE, runtime);
+	};
+}
+function requireProfileRuntime(context) {
+	const service = context.get(PROFILE_RUNTIME_SERVICE);
+	if (!service) throw new Error("Profile runtime service is unavailable");
+	return service;
+}
+//#endregion
+//#region src/services/profileText/index.ts
+const NONE = "(none)";
+const PROFILE_STATUS_KEY = "doom-profile";
+/** The command a queued voice switch invokes, and the reload handoff kind it parks. */
+const PROFILE_COMMAND = "profile";
+/**
+* The published axis content: the active profile's name, empty while
+* profiles exist with none active, and undefined to withhold the status so
+* the cockpit keeps the axis off the bar entirely.
+*/
+function profileStatus(current, hasProfiles) {
+	if (current) return current;
+	return hasProfiles ? "" : void 0;
+}
+/** Rows for the single-select profile picker. */
+function profileItems(profiles) {
+	return profiles.map((profile) => ({
+		value: profile.name,
+		label: profile.name,
+		description: profileDescription(profile)
+	}));
+}
+function profileDescription(profile) {
+	const environmentKeys = Object.keys(profile.env).sort();
+	return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(", ")})` : profile.persona;
+}
+/** Shown when the picked profile is already active. */
+function profileSummary(profile) {
+	const environmentKeys = Object.keys(profile.env).sort();
+	return [
+		`Profile ${profile.name}`,
+		`Persona: ${profile.persona}`,
+		`Env: ${environmentKeys.join(", ") || NONE}`,
+		"Already loaded."
+	].join("\n");
+}
+function profileTitle(current) {
+	return `Profile (current: ${current ?? NONE})`;
+}
+//#endregion
+Object.defineProperty(exports, "PROFILE_COMMAND", {
+	enumerable: true,
+	get: function() {
+		return PROFILE_COMMAND;
+	}
+});
+Object.defineProperty(exports, "PROFILE_RUNTIME_SERVICE", {
+	enumerable: true,
+	get: function() {
+		return PROFILE_RUNTIME_SERVICE;
+	}
+});
+Object.defineProperty(exports, "PROFILE_STATUS_KEY", {
+	enumerable: true,
+	get: function() {
+		return PROFILE_STATUS_KEY;
+	}
+});
+Object.defineProperty(exports, "createProfileRuntime", {
+	enumerable: true,
+	get: function() {
+		return createProfileRuntime;
+	}
+});
+Object.defineProperty(exports, "createProfileRuntimePlugin", {
+	enumerable: true,
+	get: function() {
+		return createProfileRuntimePlugin;
+	}
+});
+Object.defineProperty(exports, "profileDescription", {
+	enumerable: true,
+	get: function() {
+		return profileDescription;
+	}
+});
+Object.defineProperty(exports, "profileItems", {
+	enumerable: true,
+	get: function() {
+		return profileItems;
+	}
+});
+Object.defineProperty(exports, "profileStatus", {
+	enumerable: true,
+	get: function() {
+		return profileStatus;
+	}
+});
+Object.defineProperty(exports, "profileSummary", {
+	enumerable: true,
+	get: function() {
+		return profileSummary;
+	}
+});
+Object.defineProperty(exports, "profileTitle", {
+	enumerable: true,
+	get: function() {
+		return profileTitle;
+	}
+});
+Object.defineProperty(exports, "requireProfileRuntime", {
+	enumerable: true,
+	get: function() {
+		return requireProfileRuntime;
+	}
+});
+
+//# sourceMappingURL=profileText-BkeG0Ulo.cjs.map

package/dist/profileText-BkeG0Ulo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"profileText-BkeG0Ulo.cjs","names":["parseProfileBinding"],"sources":["../src/constants/profileRuntime.ts","../src/services/profileRuntime/index.ts","../src/services/profileText/index.ts"],"sourcesContent":["export const PROFILE_RUNTIME_SERVICE = 'po/profile-runtime';\n","import { parseProfileBinding } from '@agimon-ai/po-config/profiles';\nimport type { Context } from '@deepseek-ai/cordis';\n\nimport { PROFILE_RUNTIME_SERVICE } from '../../constants/profileRuntime';\nimport type {\n  ProfileProviderFactory,\n  ProfileRuntime,\n  ProfileRuntimeOptions,\n  ProfileRuntimeSnapshot,\n  ProfileSecretRequest,\n  ProfileSecretResolver,\n} from './type';\n\nconst UNAVAILABLE = 'Profile integration provider is unavailable';\nconst INVALIDATED = 'Profile operation was invalidated';\n\n/** A single selected profile and provider, owned by one session, not a provider registry. */\nclass SessionProfileRuntime implements ProfileRuntime {\n  private controller = new AbortController();\n  private snapshot: ProfileRuntimeSnapshot;\n  private provider?: { name: string; factory: ProfileProviderFactory };\n  private connection?: ProfileSecretResolver;\n  private transition: Promise<void> = Promise.resolve();\n  private retirement: Promise<void> = Promise.resolve();\n  private readonly pending = new Set<Promise<void>>();\n  private initializing = false;\n  private disposed = false;\n  private disposal?: Promise<void>;\n\n  constructor(private readonly options: ProfileRuntimeOptions) {\n    this.snapshot = this.capture(options.profileName, 1);\n  }\n\n  private capture(profileName: string | undefined, generation: number): ProfileRuntimeSnapshot {\n    const binding = profileName === undefined ? undefined : this.options.readBinding(profileName);\n    return Object.freeze({\n      ...(profileName === undefined ? {} : { profileName }),\n      ...(binding === undefined ? {} : { integration: parseProfileBinding(binding) }),\n      generation,\n      signal: this.controller.signal,\n    });\n  }\n\n  readSelection(): ProfileRuntimeSnapshot {\n    return this.snapshot;\n  }\n\n  invalidate(): void {\n    this.controller.abort();\n    const connection = this.connection;\n    this.connection = undefined;\n    if (connection) {\n      this.retirement = this.retirement.then(async () => {\n        try {\n          await connection.dispose();\n        } catch {\n          throw new Error('Profile provider disposal failed');\n        }\n      });\n      void this.track(this.retirement);\n    }\n  }\n\n  private track(work: Promise<void>): Promise<void> {\n    this.pending.add(work);\n    // Keep rejection observable through ready/dispose while preventing an unhandled\n    // rejection when selection invalidates an initialization before its owner awaits it.\n    void work.then(\n      () => this.pending.delete(work),\n      () => this.pending.delete(work),\n    );\n    return work;\n  }\n\n  private initialize(): Promise<void> {\n    const snapshot = this.snapshot;\n    const provider = this.provider;\n    this.initializing = Boolean(snapshot.integration && provider);\n    const work = (async () => {\n      await this.retirement;\n      if (snapshot.signal.aborted) return;\n      if (!snapshot.integration || !provider) return;\n      if (snapshot.integration.provider !== provider.name) throw new Error(UNAVAILABLE);\n      let connection: ProfileSecretResolver;\n      try {\n        connection = await provider.factory(snapshot.integration, {\n          profileName: snapshot.profileName!,\n          generation: snapshot.generation,\n          signal: snapshot.signal,\n        });\n      } catch {\n        // A retired factory commonly rejects on abort. That cannot remove the\n        // provider attachment or poison the replacement generation.\n        if (snapshot.signal.aborted) return;\n        throw new Error('Profile provider initialization failed');\n      }\n      if (snapshot.signal.aborted || this.snapshot !== snapshot || this.disposed) {\n        try {\n          await connection.dispose();\n        } catch {\n          throw new Error('Profile provider disposal failed');\n        }\n        return;\n      }\n      this.connection = connection;\n    })();\n    this.transition = this.track(\n      work.finally(() => {\n        if (this.snapshot === snapshot) this.initializing = false;\n      }),\n    );\n    return this.transition;\n  }\n\n  async select(profileName?: string): Promise<void> {\n    if (this.disposed) throw new Error(INVALIDATED);\n    if (\n      this.snapshot.profileName === profileName &&\n      !this.snapshot.signal.aborted &&\n      (!this.snapshot.integration || !this.provider || this.connection || this.initializing)\n    )\n      return;\n    this.invalidate();\n    this.controller = new AbortController();\n    // If reading/validation fails, leave the old generation aborted, never usable.\n    this.snapshot = this.capture(profileName, this.snapshot.generation + 1);\n    await this.initialize();\n  }\n\n  async ready(): Promise<void> {\n    const snapshot = this.snapshot;\n    await this.transition;\n    if (this.disposed || snapshot.signal.aborted || this.snapshot !== snapshot) throw new Error(INVALIDATED);\n    if (snapshot.integration && !this.connection) throw new Error(UNAVAILABLE);\n  }\n\n  async attachProvider(providerName: string, factory: ProfileProviderFactory): Promise<() => Promise<void>> {\n    if (this.disposed || this.snapshot.signal.aborted) throw new Error(INVALIDATED);\n    if (this.provider) throw new Error('Profile provider is already attached');\n    if (this.snapshot.integration && this.snapshot.integration.provider !== providerName) throw new Error(UNAVAILABLE);\n    const provider = { name: providerName, factory };\n    this.provider = provider;\n    try {\n      await this.initialize();\n      await this.ready();\n      if (this.disposed || this.provider !== provider) throw new Error(INVALIDATED);\n    } catch {\n      if (this.provider === provider) this.provider = undefined;\n      this.invalidate();\n      throw new Error('Profile provider initialization failed');\n    }\n    let detached = false;\n    return async () => {\n      if (detached || this.provider !== provider) return;\n      detached = true;\n      this.invalidate();\n      this.provider = undefined;\n      this.controller = new AbortController();\n      this.snapshot = Object.freeze({\n        ...this.snapshot,\n        generation: this.snapshot.generation + 1,\n        signal: this.controller.signal,\n      });\n      await this.retirement;\n    };\n  }\n\n  async resolveSecret(name: string, request: ProfileSecretRequest): Promise<string> {\n    // Do not await ready here: a provider factory invoking this callback would\n    // otherwise wait for itself. Browser creation may retain, but not invoke it.\n    if (this.initializing) throw new Error('Profile secrets are unavailable during provider initialization');\n    await this.ready();\n    const snapshot = this.snapshot;\n    const connection = this.connection;\n    const reference = snapshot.integration?.secrets[name];\n    if (!connection || !reference || !Object.hasOwn(snapshot.integration!.secrets, name)) {\n      throw new Error('Profile secret alias is unavailable');\n    }\n    if (!reference.allowedOrigins.includes(request.origin)) throw new Error('Profile secret origin is not allowed');\n    const signal = request.signal ? AbortSignal.any([snapshot.signal, request.signal]) : snapshot.signal;\n    if (signal.aborted) throw new Error(INVALIDATED);\n    let value: string;\n    try {\n      value = await connection.resolveSecret(reference, signal);\n    } catch {\n      // Provider failures must not leak API responses, credential fields or secrets.\n      throw new Error('Profile secret resolution failed');\n    }\n    if (signal.aborted || this.snapshot !== snapshot || this.connection !== connection) throw new Error(INVALIDATED);\n    if (typeof value !== 'string' || value.length === 0) throw new Error('Profile secret field is unavailable');\n    return value;\n  }\n\n  dispose(): Promise<void> {\n    if (this.disposal) return this.disposal;\n    this.disposed = true;\n    this.invalidate();\n    this.provider = undefined;\n    this.disposal = (async () => {\n      const results = await Promise.allSettled([...this.pending, this.retirement]);\n      if (results.some((result) => result.status === 'rejected')) throw new Error('Profile runtime disposal failed');\n    })();\n    return this.disposal;\n  }\n}\n\nexport function createProfileRuntime(options: ProfileRuntimeOptions): ProfileRuntime {\n  return new SessionProfileRuntime(options);\n}\n\n/** Mounted in the scoped root services array, before dependent integration tools. */\nexport function createProfileRuntimePlugin(runtime: ProfileRuntime): (context: Context) => void {\n  return (context) => {\n    context.provide(PROFILE_RUNTIME_SERVICE, runtime);\n  };\n}\n\nexport function requireProfileRuntime(context: Context): ProfileRuntime {\n  const service = context.get(PROFILE_RUNTIME_SERVICE);\n  if (!service) throw new Error('Profile runtime service is unavailable');\n  return service;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/profile-runtime': ProfileRuntime;\n  }\n}\n","import type { AgentProfile } from '@agimon-ai/po-config/profiles';\n\nconst NONE = '(none)';\n\n/** Footer status key the cockpit's profile axis reads. */\ninterface SelectItem {\n  value: string;\n  label: string;\n  description?: string;\n}\n\nexport const PROFILE_STATUS_KEY = 'doom-profile';\n\n/** Identity this package registers voice capabilities under. */\nexport const PROFILE_SOURCE = '@agimon-ai/po-profile';\n\n/** The command a queued voice switch invokes, and the reload handoff kind it parks. */\nexport const PROFILE_COMMAND = 'profile';\n\n/**\n * The published axis content: the active profile's name, empty while\n * profiles exist with none active, and undefined to withhold the status so\n * the cockpit keeps the axis off the bar entirely.\n */\nexport function profileStatus(current: string | undefined, hasProfiles: boolean): string | undefined {\n  if (current) return current;\n  return hasProfiles ? '' : undefined;\n}\n\n/** Rows for the single-select profile picker. */\nexport function profileItems(profiles: AgentProfile[]): SelectItem[] {\n  return profiles.map((profile) => ({\n    value: profile.name,\n    label: profile.name,\n    description: profileDescription(profile),\n  }));\n}\n\nexport function profileDescription(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return environmentKeys.length > 0 ? `${profile.persona} (env: ${environmentKeys.join(', ')})` : profile.persona;\n}\n\n/** Shown when the picked profile is already active. */\nexport function profileSummary(profile: AgentProfile): string {\n  const environmentKeys = Object.keys(profile.env).sort();\n  return [\n    `Profile ${profile.name}`,\n    `Persona: ${profile.persona}`,\n    `Env: ${environmentKeys.join(', ') || NONE}`,\n    'Already loaded.',\n  ].join('\\n');\n}\n\nexport function profileTitle(current?: string): string {\n  return `Profile (current: ${current ?? NONE})`;\n}\n"],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,12 @@
+# Doom Pi Profile
+
+Package-owned guidance for Po profile discovery, personas, environment defaults, and precedence.
+
+## How to author
+
+- [Author Po profiles](./src/prompts/po-author-profile/SKILL.md): Configure personal and repository profiles.
+- [Profiles authoring contract](./src/prompts/po-author-profile/references/profiles-contract.md): File locations, discovery, precedence, path safety, environment defaults, and verification.
+
+## Package reference
+
+- [Package README](./README.md): Profile behavior, activation, and public package entries.

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@agimon-ai/po-profile",
+  "version": "0.0.0-alpha.0",
+  "description": "Persona and environment profile switching for Po sessions.",
+  "keywords": [
+    "agent-persona",
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "profile-switching",
+    "system-prompt"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/po/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/po.git",
+    "directory": "packages/foundations/po-profile"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "README.md",
+    "src/prompts",
+    "LICENSE",
+    "package.json"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "jsnext:main": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./apiContracts": {
+      "types": "./dist/apiContracts.d.mts",
+      "import": "./dist/apiContracts.mjs",
+      "require": "./dist/apiContracts.cjs"
+    },
+    "./extensions/server": {
+      "types": "./dist/extensions/server.d.mts",
+      "import": "./dist/extensions/server.mjs",
+      "require": "./dist/extensions/server.cjs"
+    },
+    "./extensions/web": {
+      "import": "./dist/extensions/web.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agimon-ai/po-config": "0.0.0-alpha.0",
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-minor-mode": "0.0.0-alpha.0",
+    "@agimon-ai/po-telemetry": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "typebox": "1.3.34"
+  },
+  "devDependencies": {
+    "@agimon-ai/po-build": "0.0.0-alpha.0",
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@agimon-ai/po-voice": "0.0.0-alpha.0",
+    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.0",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@earendil-works/pi-coding-agent": "1.0.2",
+    "@types/node": "26.6.4",
+    "@vitest/coverage-v8": "5.0.3",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "peerDependencies": {
+    "@agimon-ai/po-core": "0.0.0-alpha.0",
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@agimon-ai/po-core": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "poMcp": {
+    "entry": "./generated/mcp.ts",
+    "dist": "./dist/extensions/mcp.mjs",
+    "scopes": [
+      "session"
+    ]
+  },
+  "poServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "poWeb": {
+    "pluginId": "profile",
+    "channels": [],
+    "client": "./dist/extensions/web.mjs",
+    "scopes": [
+      "session"
+    ]
+  },
+  "scripts": {
+    "build": "tsdown && pnpm build:mcp",
+    "build:mcp": "tsdown --config tsdown.mcp.config.ts",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/po-author-profile/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: po-author-profile
+description: Configure Po profile discovery, personas, environment defaults, and precedence in profiles.yaml. Use when creating or changing personal or repository profiles. Do not use for config.yaml runtime settings, modes.yaml, or domains.yaml.
+---
+
+# Author Po profiles
+
+Configure a profile as one persona plus optional environment defaults.
+
+## Workflow
+
+1. Read both `~/.po/profiles.yaml` and the repository's `.po/profiles.yaml` when they exist.
+2. Use `profiles.roots` for one-level persona discovery. Use `profiles.entries` when a profile needs an explicit persona path or environment defaults.
+3. Resolve relative roots and persona paths against the file that declares them. Keep an explicit persona inside that file's `agents/` directory or one of its configured roots.
+4. Put instructions in `profile.md`, `SOUL.md`, or `AGENTS.md`. Po concatenates non-empty files in that order.
+5. Keep every `env` value a string. Treat it as a default because an already exported value wins.
+6. Preserve the precedence rules. Explicit entries override discoveries, and repository entries override personal entries at the same precedence level.
+7. Verify the selection with `po --profile <name> --explain`, then smoke-test `/profile` when changing live switching behavior.
+
+Read [references/profiles-contract.md](references/profiles-contract.md) before changing discovery, precedence, path handling, or profile application.