@agimon-ai/po-major-mode 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vuong Ngo
+
+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/README.md

@@ -0,0 +1,87 @@
+# @agimon-ai/po-major-mode
+
+Named major-mode selection for [Po](https://www.npmjs.com/package/@agimon-ai/po) sessions.
+
+A **major mode** is one of the four axes of a Po selection, alongside domains, the profile,
+and the minor modes. It names an ordered list of layers, and each layer names the packages it
+activates:
+
+```yaml
+# .po/modes.yaml
+layers:
+  team:
+    packages: ['@agimon-ai/po-team']
+  ask-user:
+    packages: ['@agimon-ai/po-user-feedback']
+  task:
+    packages: ['@agimon-ai/po-task']
+
+majorMode:
+  minimal:
+    description: Lean mode with Team delegation and persistent tasks.
+    layers: [team, task]
+  copilot:
+    description: General coding with delegation, persistent tasks, and structured user feedback.
+    layers: [team, ask-user, task]
+```
+
+Default packages load before these layers. The `layers` array is authored activation order, not a
+set.
+
+## What it registers
+
+| Surface                 | Behavior                                                                   |
+| ----------------------- | -------------------------------------------------------------------------- |
+| `/mode`                 | picks a major mode, applies it, and reloads                                |
+| `major_mode` voice tool | `list` returns every mode with its purpose and layers; `switch` queues one |
+| status line             | `*profile*:[major-mode]:domains`, amber while a switch is pending          |
+| Help contribution       | exposes focused `modes.yaml` guidance while Po Help is active              |
+
+## Help guidance
+
+This package registers `po-author-major-mode` with the session-local `doom/help` Cordis
+service. Registration is inert until `@agimon-ai/po-help` is active. Once active, the Help
+skill routes the AI through this package's validated [`llms.txt`](./llms.txt) index.
+
+The package owns both the concise [major-mode authoring prompt](./src/prompts/po-author-major-mode/SKILL.md)
+and the detailed [`modes.yaml` contract](./src/prompts/po-author-major-mode/references/modes-contract.md),
+so the guidance is versioned with the parser and runtime that consume it.
+
+## Switching, and why it is not always a reload
+
+A major-mode change alters which extensions load, and Pi freezes the CLI `--extension` list at
+construction. So the disposition depends on how the session started:
+
+- **synchronized** (`dpi`, or regular `pi` after `po sync`): the session composes its own
+  extension set on every load, so the new layers arrive with a `pi-reload`. If the target
+  composition has no synchronized bundle yet, the transition reports `sync-required` and asks for
+  `po sync`.
+- **launcher**: the extension closure is fixed, so a mode whose layers differ needs a new process.
+  The switch is journaled as pending and the command prints the relaunch line rather than
+  pretending it applied.
+
+Either way the change is planned through the session's transition coordinator first, and active
+minor modes are captured before the reload and restored after it. A failed apply rolls the harness
+state back from a snapshot and journals the transition as aborted.
+
+The voice tool never applies a switch itself. It mints an opaque handoff token and sends
+`/mode --voice-switch-token=…` back as a follow-up, so the reload happens inside a command handler
+where it can be the terminal action.
+
+## Installation
+
+Po depends on this package and activates it as fixed host core, so a Po install already has
+it. It is not selectable from `.po/modes.yaml`. It is what reads that file.
+
+## License
+
+MIT
+
+Pi and server declarations live in `src/extensions` and build directly to `/extensions/pi`
+and `/extensions/server`. Flat root exports expose selection, status, telemetry, and schema helpers.
+Controllers own host integration; text and telemetry services live in named folders.
+
+The Pi declaration installs optional Config, Transition, and Voice service bindings before its
+command and event declarations. Session startup awaits the runtime binding before publishing status.
+The shared helper owns teardown of those bindings. Picker, selection-switch, and journal modules
+remain lazy imports, so registering `/mode` does not load them eagerly.

package/dist/apiContracts.cjs

@@ -0,0 +1,17 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = (0, require("@agimon-ai/po-core/apiContracts").defineApiContract)({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+exports.apiContracts = apiContracts;
+exports.default = apiContracts;
+
+//# sourceMappingURL=apiContracts.cjs.map

package/dist/apiContracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.cjs","names":["defineApiContract"],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;;;;AAGA,MAAa,gBAAA,4CAAeA,CAAAA,CAAAA,kBAAAA,CAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/apiContracts.d.mts

@@ -0,0 +1,53 @@
+//#region src/schemas/apiContracts.d.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+export declare const apiContracts: {
+  version: 1;
+  protocols?: Record<string, string> | undefined;
+  schemas?: Record<string, boolean | object> | undefined;
+  http: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    basePath?: string | undefined;
+    path: string;
+    method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
+    description: string;
+    availability?: string | undefined;
+    authentication: "device" | "none" | "owner";
+    parameters?: {
+      name: string;
+      in: "header" | "path" | "query";
+      required: boolean;
+      schema: boolean | object;
+    }[] | undefined;
+    body?: {
+      contentType: string;
+      contentTypes?: string[] | undefined;
+      required: boolean;
+      schema: boolean | object;
+    } | undefined;
+    responses: Record<string, {
+      description: string;
+      contentType?: string | undefined;
+      schema?: boolean | object | undefined;
+      events?: Record<string, boolean | object> | undefined;
+    }>;
+  }[];
+  sockets: {
+    id: string;
+    scope: "global" | "session" | "workspace";
+    description: string;
+    availability?: string | undefined;
+    service: string;
+    member: string;
+    direction: "client-to-server" | "server-to-client";
+    kind: "channel" | "method" | "state";
+    input: boolean | object;
+    output?: boolean | object | undefined;
+    errors?: boolean | object | undefined;
+  }[];
+  dynamic: string[];
+  gaps?: string[] | undefined;
+};
+//#endregion
+export { apiContracts as default };
+//# sourceMappingURL=apiContracts.d.mts.map

package/dist/apiContracts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.d.mts","names":[],"sources":["../src/schemas/apiContracts.ts"],"mappings":";;qBAGa"}

package/dist/apiContracts.mjs

@@ -0,0 +1,13 @@
+import { defineApiContract } from "@agimon-ai/po-core/apiContracts";
+//#region src/schemas/apiContracts.ts
+/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */
+const apiContracts = defineApiContract({
+	version: 1,
+	http: [],
+	sockets: [],
+	dynamic: []
+});
+//#endregion
+export { apiContracts, apiContracts as default };
+
+//# sourceMappingURL=apiContracts.mjs.map

package/dist/apiContracts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiContracts.mjs","names":[],"sources":["../src/schemas/apiContracts.ts"],"sourcesContent":["import { defineApiContract } from '@agimon-ai/po-core/apiContracts';\n\n/** This facet contributes agent tools, commands or lifecycle only, with no separate HTTP or socket surface. */\nexport const apiContracts = defineApiContract({ version: 1, http: [], sockets: [], dynamic: [] });\nexport default apiContracts;\n"],"mappings":";;;AAGA,MAAa,eAAe,kBAAkB;CAAE,SAAS;CAAG,MAAM,CAAC;CAAG,SAAS,CAAC;CAAG,SAAS,CAAC;AAAE,CAAC"}

package/dist/extensions/mcp.cjs

@@ -0,0 +1,26 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _agimon_ai_po_core_mcpFacet = require("@agimon-ai/po-core/mcpFacet");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp.ts
+var po_author_major_mode_mcp_default = (0, _agimon_ai_po_core_mcpFacet.defineMcpSkill)({
+	name: "po-author-major-mode",
+	description: "Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.",
+	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-author-major-mode/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = (0, _agimon_ai_po_core_mcpFacet.defineMcpPlugin)({
+	name: "@agimon-ai/po-major-mode",
+	session: (context) => ({ get skills() {
+		return [at(po_author_major_mode_mcp_default, context)];
+	} })
+});
+//#endregion
+exports.default = mcp;
+exports.mcp = mcp;
+
+//# sourceMappingURL=mcp.cjs.map

package/dist/extensions/mcp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.cjs","names":["defineMcpSkill","readPackageResource","defineMcpPlugin","skillPoAuthorMajorMode"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-author-major-mode',\n  description:\n    \"Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.\",\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoAuthorMajorMode from '../src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-major-mode',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoAuthorMajorMode, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,oCAAA,GAAeA,4BAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aACE;CACF,aAAA,GAAYC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,2CAA2C;AAC9F,CAAC;;;ACFD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,4BAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGC,kCAAwB,OAAO,CAAC;CAAG,EAC/F;AACF,CAAC"}

package/dist/extensions/mcp.d.mts

@@ -0,0 +1,5 @@
+//#region generated/mcp.d.ts
+export declare const mcp: import("@agimon-ai/po-core/mcpFacet").DoomMcpPluginDefinition;
+//#endregion
+export { mcp as default };
+//# sourceMappingURL=mcp.d.mts.map

package/dist/extensions/mcp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../../generated/mcp.ts"],"mappings":";qBASa,2CAAG"}

package/dist/extensions/mcp.mjs

@@ -0,0 +1,21 @@
+import { defineMcpPlugin, defineMcpSkill } from "@agimon-ai/po-core/mcpFacet";
+import { readPackageResource } from "@agimon-ai/po-core/serverFacet";
+//#region src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp.ts
+var po_author_major_mode_mcp_default = defineMcpSkill({
+	name: "po-author-major-mode",
+	description: "Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.",
+	read: () => readPackageResource(import.meta.url, "src/prompts/po-author-major-mode/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = defineMcpPlugin({
+	name: "@agimon-ai/po-major-mode",
+	session: (context) => ({ get skills() {
+		return [at(po_author_major_mode_mcp_default, context)];
+	} })
+});
+//#endregion
+export { mcp as default, mcp };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/extensions/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.mjs","names":["skillPoAuthorMajorMode"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/po-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'po-author-major-mode',\n  description:\n    \"Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.\",\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/po-core/mcpFacet';\n\nimport skillPoAuthorMajorMode from '../src/extensions/workspaces/sessions/(backend)/skill/po-author-major-mode.mcp';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n\nexport const mcp = defineMcpPlugin({\n  name: '@agimon-ai/po-major-mode',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillPoAuthorMajorMode, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,mCAAe,eAAe;CAC5B,MAAM;CACN,aACE;CACF,YAAY,oBAAoB,YAAY,KAAK,2CAA2C;AAC9F,CAAC;;;ACFD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,MAAM,gBAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGA,kCAAwB,OAAO,CAAC;CAAG,EAC/F;AACF,CAAC"}

package/dist/extensions/server.cjs

@@ -0,0 +1,81 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_majorModeText = require("../majorModeText-DCFGufYS.cjs");
+let _agimon_ai_po_core_serverFacet = require("@agimon-ai/po-core/serverFacet");
+let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile");
+let _agimon_ai_po_config_majorModes = require("@agimon-ai/po-config/majorModes");
+//#region src/extensions/workspaces/sessions/(backend)/_lib/majorModeServerCommand.ts
+function createMajorModeServerCommand(host) {
+	return {
+		name: require_majorModeText.MAJOR_MODE_COMMAND,
+		description: "Show or change the active Po major mode.",
+		async execute(args, execution) {
+			const config = (0, _agimon_ai_po_config_majorModes.loadMajorModesConfig)(execution.repoRoot);
+			let requested = args.trim();
+			if (!requested) {
+				const selected = await execution.client.request({
+					kind: "select",
+					title: `Major mode (current: ${execution.selection.majorMode})`,
+					options: Object.keys(config.majorMode).map((name) => ({
+						label: require_majorModeText.majorModeOptionLabel(name, config.majorMode[name]?.layers ?? [], execution.selection.majorMode),
+						value: name
+					}))
+				});
+				if (typeof selected !== "string" || !selected) return;
+				requested = selected;
+			}
+			(0, _agimon_ai_po_config_majorModes.resolveLayers)(config, requested);
+			if (requested === execution.selection.majorMode) return;
+			await host.changeSelection({
+				axis: "majorMode",
+				majorMode: requested
+			});
+		}
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/command/majorMode.server.ts
+var majorMode_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)(({ agent }) => agent ? createMajorModeServerCommand(agent) : void 0, { cardinality: "optional" });
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server.ts
+var poAuthorMajorMode_server_default = (0, _agimon_ai_po_core_extensionFile.defineResource)({
+	name: "po-author-major-mode",
+	description: "Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.",
+	when: {
+		state: { "minor-mode": "help" },
+		attribution: {
+			kind: "minor",
+			mode: "help"
+		}
+	},
+	kind: "skill",
+	path: (0, _agimon_ai_po_core_serverFacet.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-author-major-mode/SKILL.md"),
+	read: () => (0, _agimon_ai_po_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/po-author-major-mode/SKILL.md")
+});
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/po-major-mode",
+	session: (context) => ({
+		get commands() {
+			return defined([via({ name: "major-mode" }, at(majorMode_server_default, context))]);
+		},
+		get resources() {
+			return [at(poAuthorMajorMode_server_default, context)];
+		}
+	})
+});
+//#endregion
+exports.default = facet;
+exports.facet = facet;
+
+//# sourceMappingURL=server.cjs.map

package/dist/extensions/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","names":["MAJOR_MODE_COMMAND","loadMajorModesConfig","majorModeOptionLabel","defineRoutedContribution","defineResource","packageResourcePath","readPackageResource","defineServerPlugin","commandMajorMode","resourcePoAuthorMajorMode"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/majorModeServerCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/majorMode.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server.ts","../../generated/server.ts"],"sourcesContent":["import { loadMajorModesConfig, resolveLayers } from '@agimon-ai/po-config/majorModes';\nimport { type DoomHeadlessCommand, type DoomHeadlessHostService } from '@agimon-ai/po-core/headless';\n\nimport { MAJOR_MODE_COMMAND, majorModeOptionLabel } from '../../../../../services/majorModeText';\n\nexport function createMajorModeServerCommand(host: DoomHeadlessHostService): DoomHeadlessCommand {\n  return {\n    name: MAJOR_MODE_COMMAND,\n    description: 'Show or change the active Po major mode.',\n    async execute(args, execution) {\n      const config = loadMajorModesConfig(execution.repoRoot);\n      let requested = args.trim();\n      if (!requested) {\n        const selected = await execution.client.request({\n          kind: 'select',\n          title: `Major mode (current: ${execution.selection.majorMode})`,\n          options: Object.keys(config.majorMode).map((name) => ({\n            label: majorModeOptionLabel(name, config.majorMode[name]?.layers ?? [], execution.selection.majorMode),\n            value: name,\n          })),\n        });\n        if (typeof selected !== 'string' || !selected) return;\n        requested = selected;\n      }\n      // Reject invalid command input before requesting a capability transition.\n      resolveLayers(config, requested);\n      if (requested === execution.selection.majorMode) return;\n      await host.changeSelection({ axis: 'majorMode', majorMode: requested });\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport { createMajorModeServerCommand } from '../_lib/majorModeServerCommand';\nexport default defineRoutedContribution(\n  ({ agent }: DoomServerPluginContext) => (agent ? createMajorModeServerCommand(agent) : undefined),\n  { cardinality: 'optional' },\n);\n","import { defineResource } from '@agimon-ai/po-core/extensionFile';\nimport { packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineResource({\n  name: 'po-author-major-mode',\n  description:\n    \"Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.\",\n  when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n  kind: 'skill' as const,\n  path: packageResourcePath(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport commandMajorMode from '../src/extensions/workspaces/sessions/(backend)/command/majorMode.server';\nimport resourcePoAuthorMajorMode from '../src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-major-mode',\n  session: (context) => ({\n    get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'major-mode' }, at(commandMajorMode, context))]); },\n    get resources(): DoomServerSessionPlugin['resources'] { return [at(resourcePoAuthorMajorMode, context)]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;;;;AAKA,SAAgB,6BAA6B,MAAoD;CAC/F,OAAO;EACL,MAAMA,sBAAAA;EACN,aAAa;EACb,MAAM,QAAQ,MAAM,WAAW;GAC7B,MAAM,UAAA,GAASC,gCAAAA,qBAAAA,CAAqB,UAAU,QAAQ;GACtD,IAAI,YAAY,KAAK,KAAK;GAC1B,IAAI,CAAC,WAAW;IACd,MAAM,WAAW,MAAM,UAAU,OAAO,QAAQ;KAC9C,MAAM;KACN,OAAO,wBAAwB,UAAU,UAAU,UAAU;KAC7D,SAAS,OAAO,KAAK,OAAO,SAAS,CAAC,CAAC,KAAK,UAAU;MACpD,OAAOC,sBAAAA,qBAAqB,MAAM,OAAO,UAAU,KAAK,EAAE,UAAU,CAAC,GAAG,UAAU,UAAU,SAAS;MACrG,OAAO;KACT,EAAE;IACJ,CAAC;IACD,IAAI,OAAO,aAAa,YAAY,CAAC,UAAU;IAC/C,YAAY;GACd;GAEA,CAAA,GAAA,gCAAA,cAAA,CAAc,QAAQ,SAAS;GAC/B,IAAI,cAAc,UAAU,UAAU,WAAW;GACjD,MAAM,KAAK,gBAAgB;IAAE,MAAM;IAAa,WAAW;GAAU,CAAC;EACxE;CACF;AACF;;;AC1BA,IAAA,4BAAA,GAAeC,iCAAAA,yBAAAA,EACZ,EAAE,YAAsC,QAAQ,6BAA6B,KAAK,IAAI,KAAA,GACvF,EAAE,aAAa,WAAW,CAC5B;;;ACJA,IAAA,oCAAA,GAAeC,iCAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aACE;CACF,MAAM;EAAE,OAAO,EAAE,cAAc,OAAO;EAAG,aAAa;GAAE,MAAM;GAAkB,MAAM;EAAO;CAAE;CAC/F,MAAM;CACN,OAAA,GAAMC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,2CAA2C;CACtF,aAAA,GAAYC,+BAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,2CAA2C;AAC9F,CAAC;;;ACJD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;;AAEpE,MAAM,WAAc,WAClB,OAAO,QAAQ,UAAsB,UAAU,KAAA,CAAS;AAC1D,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,SAAA,GAAQC,+BAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,UAAU,aAAa;EACrB,IAAI,WAAgD;GAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,GAAG,GAAGC,0BAAkB,OAAO,CAAC,CAAC,CAAC;EAAG;EACpI,IAAI,YAAkD;GAAE,OAAO,CAAC,GAAGC,kCAA2B,OAAO,CAAC;EAAG;CAC3G;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+//#endregion
+export { facet as default };
+//# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../generated/server.ts"],"mappings":";qBAea,gDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,76 @@
+import { i as majorModeOptionLabel, t as MAJOR_MODE_COMMAND } from "../majorModeText-DuWMOhxX.mjs";
+import { defineServerPlugin, packageResourcePath, readPackageResource } from "@agimon-ai/po-core/serverFacet";
+import { defineResource, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
+import { loadMajorModesConfig, resolveLayers } from "@agimon-ai/po-config/majorModes";
+//#region src/extensions/workspaces/sessions/(backend)/_lib/majorModeServerCommand.ts
+function createMajorModeServerCommand(host) {
+	return {
+		name: MAJOR_MODE_COMMAND,
+		description: "Show or change the active Po major mode.",
+		async execute(args, execution) {
+			const config = loadMajorModesConfig(execution.repoRoot);
+			let requested = args.trim();
+			if (!requested) {
+				const selected = await execution.client.request({
+					kind: "select",
+					title: `Major mode (current: ${execution.selection.majorMode})`,
+					options: Object.keys(config.majorMode).map((name) => ({
+						label: majorModeOptionLabel(name, config.majorMode[name]?.layers ?? [], execution.selection.majorMode),
+						value: name
+					}))
+				});
+				if (typeof selected !== "string" || !selected) return;
+				requested = selected;
+			}
+			resolveLayers(config, requested);
+			if (requested === execution.selection.majorMode) return;
+			await host.changeSelection({
+				axis: "majorMode",
+				majorMode: requested
+			});
+		}
+	};
+}
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/command/majorMode.server.ts
+var majorMode_server_default = defineRoutedContribution(({ agent }) => agent ? createMajorModeServerCommand(agent) : void 0, { cardinality: "optional" });
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server.ts
+var poAuthorMajorMode_server_default = defineResource({
+	name: "po-author-major-mode",
+	description: "Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.",
+	when: {
+		state: { "minor-mode": "help" },
+		attribution: {
+			kind: "minor",
+			mode: "help"
+		}
+	},
+	kind: "skill",
+	path: packageResourcePath(import.meta.url, "src/prompts/po-author-major-mode/SKILL.md"),
+	read: () => readPackageResource(import.meta.url, "src/prompts/po-author-major-mode/SKILL.md")
+});
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+/* v8 ignore next -- generated normalization branch */
+const defined = (values) => values.filter((value) => value !== void 0);
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = defineServerPlugin({
+	name: "@agimon-ai/po-major-mode",
+	session: (context) => ({
+		get commands() {
+			return defined([via({ name: "major-mode" }, at(majorMode_server_default, context))]);
+		},
+		get resources() {
+			return [at(poAuthorMajorMode_server_default, context)];
+		}
+	})
+});
+//#endregion
+export { facet as default, facet };
+
+//# sourceMappingURL=server.mjs.map

package/dist/extensions/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":["commandMajorMode","resourcePoAuthorMajorMode"],"sources":["../../src/extensions/workspaces/sessions/(backend)/_lib/majorModeServerCommand.ts","../../src/extensions/workspaces/sessions/(backend)/command/majorMode.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server.ts","../../generated/server.ts"],"sourcesContent":["import { loadMajorModesConfig, resolveLayers } from '@agimon-ai/po-config/majorModes';\nimport { type DoomHeadlessCommand, type DoomHeadlessHostService } from '@agimon-ai/po-core/headless';\n\nimport { MAJOR_MODE_COMMAND, majorModeOptionLabel } from '../../../../../services/majorModeText';\n\nexport function createMajorModeServerCommand(host: DoomHeadlessHostService): DoomHeadlessCommand {\n  return {\n    name: MAJOR_MODE_COMMAND,\n    description: 'Show or change the active Po major mode.',\n    async execute(args, execution) {\n      const config = loadMajorModesConfig(execution.repoRoot);\n      let requested = args.trim();\n      if (!requested) {\n        const selected = await execution.client.request({\n          kind: 'select',\n          title: `Major mode (current: ${execution.selection.majorMode})`,\n          options: Object.keys(config.majorMode).map((name) => ({\n            label: majorModeOptionLabel(name, config.majorMode[name]?.layers ?? [], execution.selection.majorMode),\n            value: name,\n          })),\n        });\n        if (typeof selected !== 'string' || !selected) return;\n        requested = selected;\n      }\n      // Reject invalid command input before requesting a capability transition.\n      resolveLayers(config, requested);\n      if (requested === execution.selection.majorMode) return;\n      await host.changeSelection({ axis: 'majorMode', majorMode: requested });\n    },\n  };\n}\n","import { defineRoutedContribution } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport { createMajorModeServerCommand } from '../_lib/majorModeServerCommand';\nexport default defineRoutedContribution(\n  ({ agent }: DoomServerPluginContext) => (agent ? createMajorModeServerCommand(agent) : undefined),\n  { cardinality: 'optional' },\n);\n","import { defineResource } from '@agimon-ai/po-core/extensionFile';\nimport { packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineResource({\n  name: 'po-author-major-mode',\n  description:\n    \"Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.\",\n  when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n  kind: 'skill' as const,\n  path: packageResourcePath(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n  read: () => readPackageResource(import.meta.url, 'src/prompts/po-author-major-mode/SKILL.md'),\n});\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport commandMajorMode from '../src/extensions/workspaces/sessions/(backend)/command/majorMode.server';\nimport resourcePoAuthorMajorMode from '../src/extensions/workspaces/sessions/(backend)/resource/poAuthorMajorMode.server';\n\ntype Factory<T, C> = (context: C) => T;\nconst at = <T, C>(value: T | Factory<T, C>, context: C): T =>\n  typeof value === 'function' ? (value as Factory<T, C>)(context) : value;\n/* v8 ignore next -- generated normalization branch */\nconst defined = <T>(values: readonly (T | undefined)[]): T[] =>\n  values.filter((value): value is T => value !== undefined);\nconst via = <T>(identity: Record<string, unknown>, value: unknown): T =>\n  (value === undefined ? undefined : { ...identity, ...(value as object) }) as T;\n\nexport const facet = defineServerPlugin({\n  name: '@agimon-ai/po-major-mode',\n  session: (context) => ({\n    get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'major-mode' }, at(commandMajorMode, context))]); },\n    get resources(): DoomServerSessionPlugin['resources'] { return [at(resourcePoAuthorMajorMode, context)]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;AAKA,SAAgB,6BAA6B,MAAoD;CAC/F,OAAO;EACL,MAAM;EACN,aAAa;EACb,MAAM,QAAQ,MAAM,WAAW;GAC7B,MAAM,SAAS,qBAAqB,UAAU,QAAQ;GACtD,IAAI,YAAY,KAAK,KAAK;GAC1B,IAAI,CAAC,WAAW;IACd,MAAM,WAAW,MAAM,UAAU,OAAO,QAAQ;KAC9C,MAAM;KACN,OAAO,wBAAwB,UAAU,UAAU,UAAU;KAC7D,SAAS,OAAO,KAAK,OAAO,SAAS,CAAC,CAAC,KAAK,UAAU;MACpD,OAAO,qBAAqB,MAAM,OAAO,UAAU,KAAK,EAAE,UAAU,CAAC,GAAG,UAAU,UAAU,SAAS;MACrG,OAAO;KACT,EAAE;IACJ,CAAC;IACD,IAAI,OAAO,aAAa,YAAY,CAAC,UAAU;IAC/C,YAAY;GACd;GAEA,cAAc,QAAQ,SAAS;GAC/B,IAAI,cAAc,UAAU,UAAU,WAAW;GACjD,MAAM,KAAK,gBAAgB;IAAE,MAAM;IAAa,WAAW;GAAU,CAAC;EACxE;CACF;AACF;;;AC1BA,IAAA,2BAAe,0BACZ,EAAE,YAAsC,QAAQ,6BAA6B,KAAK,IAAI,KAAA,GACvF,EAAE,aAAa,WAAW,CAC5B;;;ACJA,IAAA,mCAAe,eAAe;CAC5B,MAAM;CACN,aACE;CACF,MAAM;EAAE,OAAO,EAAE,cAAc,OAAO;EAAG,aAAa;GAAE,MAAM;GAAkB,MAAM;EAAO;CAAE;CAC/F,MAAM;CACN,MAAM,oBAAoB,YAAY,KAAK,2CAA2C;CACtF,YAAY,oBAAoB,YAAY,KAAK,2CAA2C;AAC9F,CAAC;;;ACJD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;;AAEpE,MAAM,WAAc,WAClB,OAAO,QAAQ,UAAsB,UAAU,KAAA,CAAS;AAC1D,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,QAAQ,mBAAmB;CACtC,MAAM;CACN,UAAU,aAAa;EACrB,IAAI,WAAgD;GAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,GAAG,GAAGA,0BAAkB,OAAO,CAAC,CAAC,CAAC;EAAG;EACpI,IAAI,YAAkD;GAAE,OAAO,CAAC,GAAGC,kCAA2B,OAAO,CAAC;EAAG;CAC3G;AACF,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_majorModeText = require("./majorModeText-DCFGufYS.cjs");
+//#region src/services/statusLine/index.ts
+const STATUS_KEY = "doom-major-mode";
+/** Compact footer text for the selected major mode, domains, and profile. */
+function statusText(majorMode, domains, profile) {
+	return [
+		profile ? `*${profile}*` : void 0,
+		`[${majorMode}]`,
+		domains.join(",")
+	].filter((part) => Boolean(part)).join(":");
+}
+//#endregion
+//#region src/types/majorMode.ts
+/** The npm name this package registers its voice tool and contributions under. */
+const MAJOR_MODE_SOURCE = "@agimon-ai/po-major-mode";
+//#endregion
+exports.MAJOR_MODE_COMMAND = require_majorModeText.MAJOR_MODE_COMMAND;
+exports.MAJOR_MODE_SOURCE = MAJOR_MODE_SOURCE;
+exports.STATUS_KEY = STATUS_KEY;
+exports.applySummary = require_majorModeText.applySummary;
+exports.majorModeItems = require_majorModeText.majorModeItems;
+exports.majorModeOptionLabel = require_majorModeText.majorModeOptionLabel;
+exports.majorModeSummary = require_majorModeText.majorModeSummary;
+exports.optionName = require_majorModeText.optionName;
+exports.statusText = statusText;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/services/statusLine/index.ts","../src/types/majorMode.ts"],"sourcesContent":["export const STATUS_KEY = 'doom-major-mode';\n\n/** Compact footer text for the selected major mode, domains, and profile. */\nexport function statusText(majorMode: string, domains: readonly string[], profile?: string): string {\n  return [profile ? `*${profile}*` : undefined, `[${majorMode}]`, domains.join(',')]\n    .filter((part) => Boolean(part))\n    .join(':');\n}\n","import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\n\n/** The npm name this package registers its voice tool and contributions under. */\nexport const MAJOR_MODE_SOURCE = '@agimon-ai/po-major-mode';\n\n/** The selection as both the command and the voice tool need to see it. */\nexport interface MajorModeView {\n  config: MajorModesConfig;\n  majorMode: string;\n  domains: readonly string[];\n  profile?: string;\n}\n"],"mappings":";;;AAAA,MAAa,aAAa;;AAG1B,SAAgB,WAAW,WAAmB,SAA4B,SAA0B;CAClG,OAAO;EAAC,UAAU,IAAI,QAAQ,KAAK,KAAA;EAAW,IAAI,UAAU;EAAI,QAAQ,KAAK,GAAG;CAAC,CAAC,CAC/E,QAAQ,SAAS,QAAQ,IAAI,CAAC,CAAC,CAC/B,KAAK,GAAG;AACb;;;;ACJA,MAAa,oBAAoB"}

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+import { MajorModesConfig } from "@agimon-ai/po-config/majorModes";
+import { TransitionExecutionStrategy } from "@agimon-ai/po-core/transition";
+//#region src/services/majorModeText/index.d.ts
+interface SelectItem {
+  value: string;
+  label: string;
+  description?: string;
+}
+export declare const MAJOR_MODE_COMMAND = "mode";
+/** Picker rows show the resolved layers while retaining bare major mode values. */
+export declare function majorModeItems(config: MajorModesConfig, names: string[]): SelectItem[];
+export declare function majorModeOptionLabel(name: string, layers: string[], current: string): string;
+export declare function optionName(option: string): string;
+/**
+ * What a switch actually applied.
+ *
+ * A synced session composes its extension set on every load, so a reload picks
+ * up the new layers outright. A launcher session cannot: Pi freezes the CLI
+ * `--extension` list at construction, so a layer that contributes extensions
+ * needs a relaunch there and only the hooks change in place.
+ */
+export declare function applySummary(picked: string, layers: string[], stale: boolean, composed?: boolean, strategy?: TransitionExecutionStrategy, supervised?: boolean): string;
+export declare function majorModeSummary(picked: string, layers: string[], current: string, composed?: boolean): string;
+//#endregion
+//#region src/services/statusLine/index.d.ts
+export declare const STATUS_KEY = "doom-major-mode";
+/** Compact footer text for the selected major mode, domains, and profile. */
+export declare function statusText(majorMode: string, domains: readonly string[], profile?: string): string;
+//#endregion
+//#region src/types/majorMode.d.ts
+/** The npm name this package registers its voice tool and contributions under. */
+export declare const MAJOR_MODE_SOURCE = "@agimon-ai/po-major-mode";
+/** The selection as both the command and the voice tool need to see it. */
+interface MajorModeView {
+  config: MajorModesConfig;
+  majorMode: string;
+  domains: readonly string[];
+  profile?: string;
+}
+//#endregion
+export type { MajorModeView };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/services/majorModeText/index.ts","../src/services/statusLine/index.ts","../src/types/majorMode.ts"],"mappings":";;;UASU;EACR;EACA;EACA;;qBAGW;;wBAGG,eAAe,QAAQ,kBAAkB,kBAAkB;wBAQ3D,qBAAqB,cAAc,kBAAkB;wBAIrD,WAAW;;;;;;;;;wBAYX,aACd,gBACA,kBACA,gBACA,oBACA,WAAW,6BACX;wBAqBc,iBAAiB,gBAAgB,kBAAkB,iBAAiB;;;qBCrEvE;;wBAGG,WAAW,mBAAmB,4BAA4B;;;;qBCA7D;;UAGI;EACf,QAAQ;EACR;EACA;EACA"}

package/dist/index.mjs

@@ -0,0 +1,19 @@
+import { a as majorModeSummary, i as majorModeOptionLabel, n as applySummary, o as optionName, r as majorModeItems, t as MAJOR_MODE_COMMAND } from "./majorModeText-DuWMOhxX.mjs";
+//#region src/services/statusLine/index.ts
+const STATUS_KEY = "doom-major-mode";
+/** Compact footer text for the selected major mode, domains, and profile. */
+function statusText(majorMode, domains, profile) {
+	return [
+		profile ? `*${profile}*` : void 0,
+		`[${majorMode}]`,
+		domains.join(",")
+	].filter((part) => Boolean(part)).join(":");
+}
+//#endregion
+//#region src/types/majorMode.ts
+/** The npm name this package registers its voice tool and contributions under. */
+const MAJOR_MODE_SOURCE = "@agimon-ai/po-major-mode";
+//#endregion
+export { MAJOR_MODE_COMMAND, MAJOR_MODE_SOURCE, STATUS_KEY, applySummary, majorModeItems, majorModeOptionLabel, majorModeSummary, optionName, statusText };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/services/statusLine/index.ts","../src/types/majorMode.ts"],"sourcesContent":["export const STATUS_KEY = 'doom-major-mode';\n\n/** Compact footer text for the selected major mode, domains, and profile. */\nexport function statusText(majorMode: string, domains: readonly string[], profile?: string): string {\n  return [profile ? `*${profile}*` : undefined, `[${majorMode}]`, domains.join(',')]\n    .filter((part) => Boolean(part))\n    .join(':');\n}\n","import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\n\n/** The npm name this package registers its voice tool and contributions under. */\nexport const MAJOR_MODE_SOURCE = '@agimon-ai/po-major-mode';\n\n/** The selection as both the command and the voice tool need to see it. */\nexport interface MajorModeView {\n  config: MajorModesConfig;\n  majorMode: string;\n  domains: readonly string[];\n  profile?: string;\n}\n"],"mappings":";;AAAA,MAAa,aAAa;;AAG1B,SAAgB,WAAW,WAAmB,SAA4B,SAA0B;CAClG,OAAO;EAAC,UAAU,IAAI,QAAQ,KAAK,KAAA;EAAW,IAAI,UAAU;EAAI,QAAQ,KAAK,GAAG;CAAC,CAAC,CAC/E,QAAQ,SAAS,QAAQ,IAAI,CAAC,CAAC,CAC/B,KAAK,GAAG;AACb;;;;ACJA,MAAa,oBAAoB"}

package/dist/majorModeText-DCFGufYS.cjs

@@ -0,0 +1,89 @@
+//#region src/services/majorModeText/index.ts
+const OPTION_PREFIX = /^\[[ x]\] /;
+const CORE_ONLY = "core only";
+const MARK_ON = "[x]";
+const MARK_OFF = "[ ]";
+const RELAUNCH = "Relaunch with:";
+const MAJOR_MODE_OPTION = "--major-mode";
+const MAJOR_MODE_COMMAND = "mode";
+/** Picker rows show the resolved layers while retaining bare major mode values. */
+function majorModeItems(config, names) {
+	return names.map((name) => ({
+		value: name,
+		label: name,
+		description: config.majorMode[name]?.description ?? CORE_ONLY
+	}));
+}
+function majorModeOptionLabel(name, layers, current) {
+	return `${name === current ? MARK_ON : MARK_OFF} ${name}: ${layers.join(", ") || CORE_ONLY}`;
+}
+function optionName(option) {
+	return option.replace(OPTION_PREFIX, "").split(":")[0] ?? option;
+}
+/**
+* What a switch actually applied.
+*
+* A synced session composes its extension set on every load, so a reload picks
+* up the new layers outright. A launcher session cannot: Pi freezes the CLI
+* `--extension` list at construction, so a layer that contributes extensions
+* needs a relaunch there and only the hooks change in place.
+*/
+function applySummary(picked, layers, stale, composed = false, strategy, supervised = false) {
+	const head = `Switched to ${picked}: ${layers.join(", ") || CORE_ONLY}`;
+	if (strategy === "process-relaunch") {
+		if (supervised) return `Major mode ${picked} is pending; the supervisor is restarting the agent with it.`;
+		return [`Major mode ${picked} is pending; the current process remains active.`, `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join("\n");
+	}
+	if (strategy === "pi-reload") return [head, "Pi reloaded."].join("\n");
+	if (!stale || composed) return [head, "Hooks reloaded."].join("\n");
+	return [
+		head,
+		"Hooks reloaded. Extensions are fixed at launch, so for those:",
+		`  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`
+	].join("\n");
+}
+function majorModeSummary(picked, layers, current, composed = false) {
+	const contents = `Major mode ${picked}: ${layers.join(", ") || CORE_ONLY}`;
+	if (picked !== current && !composed) return [contents, `${RELAUNCH}\n  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join("\n");
+	if (picked !== current) return contents;
+	return [contents, "Already using this major mode."].join("\n");
+}
+//#endregion
+Object.defineProperty(exports, "MAJOR_MODE_COMMAND", {
+	enumerable: true,
+	get: function() {
+		return MAJOR_MODE_COMMAND;
+	}
+});
+Object.defineProperty(exports, "applySummary", {
+	enumerable: true,
+	get: function() {
+		return applySummary;
+	}
+});
+Object.defineProperty(exports, "majorModeItems", {
+	enumerable: true,
+	get: function() {
+		return majorModeItems;
+	}
+});
+Object.defineProperty(exports, "majorModeOptionLabel", {
+	enumerable: true,
+	get: function() {
+		return majorModeOptionLabel;
+	}
+});
+Object.defineProperty(exports, "majorModeSummary", {
+	enumerable: true,
+	get: function() {
+		return majorModeSummary;
+	}
+});
+Object.defineProperty(exports, "optionName", {
+	enumerable: true,
+	get: function() {
+		return optionName;
+	}
+});
+
+//# sourceMappingURL=majorModeText-DCFGufYS.cjs.map

package/dist/majorModeText-DCFGufYS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"majorModeText-DCFGufYS.cjs","names":[],"sources":["../src/services/majorModeText/index.ts"],"sourcesContent":["import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport type { TransitionExecutionStrategy } from '@agimon-ai/po-core/transition';\n\nconst OPTION_PREFIX = /^\\[[ x]\\] /;\nconst CORE_ONLY = 'core only';\nconst MARK_ON = '[x]';\nconst MARK_OFF = '[ ]';\nconst RELAUNCH = 'Relaunch with:';\nconst MAJOR_MODE_OPTION = '--major-mode';\ninterface SelectItem {\n  value: string;\n  label: string;\n  description?: string;\n}\n\nexport const MAJOR_MODE_COMMAND = 'mode';\n\n/** Picker rows show the resolved layers while retaining bare major mode values. */\nexport function majorModeItems(config: MajorModesConfig, names: string[]): SelectItem[] {\n  return names.map((name) => ({\n    value: name,\n    label: name,\n    description: config.majorMode[name]?.description ?? CORE_ONLY,\n  }));\n}\n\nexport function majorModeOptionLabel(name: string, layers: string[], current: string): string {\n  return `${name === current ? MARK_ON : MARK_OFF} ${name}: ${layers.join(', ') || CORE_ONLY}`;\n}\n\nexport function optionName(option: string): string {\n  return option.replace(OPTION_PREFIX, '').split(':')[0] ?? option;\n}\n\n/**\n * What a switch actually applied.\n *\n * A synced session composes its extension set on every load, so a reload picks\n * up the new layers outright. A launcher session cannot: Pi freezes the CLI\n * `--extension` list at construction, so a layer that contributes extensions\n * needs a relaunch there and only the hooks change in place.\n */\nexport function applySummary(\n  picked: string,\n  layers: string[],\n  stale: boolean,\n  composed = false,\n  strategy?: TransitionExecutionStrategy,\n  supervised = false,\n): string {\n  const head = `Switched to ${picked}: ${layers.join(', ') || CORE_ONLY}`;\n  if (strategy === 'process-relaunch') {\n    if (supervised) {\n      return `Major mode ${picked} is pending; the supervisor is restarting the agent with it.`;\n    }\n    return [\n      `Major mode ${picked} is pending; the current process remains active.`,\n      `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`,\n    ].join('\\n');\n  }\n  if (strategy === 'pi-reload') return [head, 'Pi reloaded.'].join('\\n');\n  if (!stale || composed) return [head, 'Hooks reloaded.'].join('\\n');\n  return [\n    head,\n    'Hooks reloaded. Extensions are fixed at launch, so for those:',\n    `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`,\n  ].join('\\n');\n}\n\nexport function majorModeSummary(picked: string, layers: string[], current: string, composed = false): string {\n  const contents = `Major mode ${picked}: ${layers.join(', ') || CORE_ONLY}`;\n  if (picked !== current && !composed) {\n    return [contents, `${RELAUNCH}\\n  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join('\\n');\n  }\n  if (picked !== current) return contents;\n  return [contents, 'Already using this major mode.'].join('\\n');\n}\n\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";AAGA,MAAM,gBAAgB;AACtB,MAAM,YAAY;AAClB,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,oBAAoB;AAO1B,MAAa,qBAAqB;;AAGlC,SAAgB,eAAe,QAA0B,OAA+B;CACtF,OAAO,MAAM,KAAK,UAAU;EAC1B,OAAO;EACP,OAAO;EACP,aAAa,OAAO,UAAU,KAAK,EAAE,eAAe;CACtD,EAAE;AACJ;AAEA,SAAgB,qBAAqB,MAAc,QAAkB,SAAyB;CAC5F,OAAO,GAAG,SAAS,UAAU,UAAU,SAAS,GAAG,KAAK,IAAI,OAAO,KAAK,IAAI,KAAK;AACnF;AAEA,SAAgB,WAAW,QAAwB;CACjD,OAAO,OAAO,QAAQ,eAAe,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM;AAC5D;;;;;;;;;AAUA,SAAgB,aACd,QACA,QACA,OACA,WAAW,OACX,UACA,aAAa,OACL;CACR,MAAM,OAAO,eAAe,OAAO,IAAI,OAAO,KAAK,IAAI,KAAK;CAC5D,IAAI,aAAa,oBAAoB;EACnC,IAAI,YACF,OAAO,cAAc,OAAO;EAE9B,OAAO,CACL,cAAc,OAAO,mDACrB,aAAa,kBAAkB,GAAG,QACpC,CAAC,CAAC,KAAK,IAAI;CACb;CACA,IAAI,aAAa,aAAa,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC,KAAK,IAAI;CACrE,IAAI,CAAC,SAAS,UAAU,OAAO,CAAC,MAAM,iBAAiB,CAAC,CAAC,KAAK,IAAI;CAClE,OAAO;EACL;EACA;EACA,aAAa,kBAAkB,GAAG;CACpC,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAgB,iBAAiB,QAAgB,QAAkB,SAAiB,WAAW,OAAe;CAC5G,MAAM,WAAW,cAAc,OAAO,IAAI,OAAO,KAAK,IAAI,KAAK;CAC/D,IAAI,WAAW,WAAW,CAAC,UACzB,OAAO,CAAC,UAAU,GAAG,SAAS,cAAc,kBAAkB,GAAG,QAAQ,CAAC,CAAC,KAAK,IAAI;CAEtF,IAAI,WAAW,SAAS,OAAO;CAC/B,OAAO,CAAC,UAAU,gCAAgC,CAAC,CAAC,KAAK,IAAI;AAC/D"}

package/dist/majorModeText-DuWMOhxX.mjs

@@ -0,0 +1,54 @@
+//#region src/services/majorModeText/index.ts
+const OPTION_PREFIX = /^\[[ x]\] /;
+const CORE_ONLY = "core only";
+const MARK_ON = "[x]";
+const MARK_OFF = "[ ]";
+const RELAUNCH = "Relaunch with:";
+const MAJOR_MODE_OPTION = "--major-mode";
+const MAJOR_MODE_COMMAND = "mode";
+/** Picker rows show the resolved layers while retaining bare major mode values. */
+function majorModeItems(config, names) {
+	return names.map((name) => ({
+		value: name,
+		label: name,
+		description: config.majorMode[name]?.description ?? CORE_ONLY
+	}));
+}
+function majorModeOptionLabel(name, layers, current) {
+	return `${name === current ? MARK_ON : MARK_OFF} ${name}: ${layers.join(", ") || CORE_ONLY}`;
+}
+function optionName(option) {
+	return option.replace(OPTION_PREFIX, "").split(":")[0] ?? option;
+}
+/**
+* What a switch actually applied.
+*
+* A synced session composes its extension set on every load, so a reload picks
+* up the new layers outright. A launcher session cannot: Pi freezes the CLI
+* `--extension` list at construction, so a layer that contributes extensions
+* needs a relaunch there and only the hooks change in place.
+*/
+function applySummary(picked, layers, stale, composed = false, strategy, supervised = false) {
+	const head = `Switched to ${picked}: ${layers.join(", ") || CORE_ONLY}`;
+	if (strategy === "process-relaunch") {
+		if (supervised) return `Major mode ${picked} is pending; the supervisor is restarting the agent with it.`;
+		return [`Major mode ${picked} is pending; the current process remains active.`, `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join("\n");
+	}
+	if (strategy === "pi-reload") return [head, "Pi reloaded."].join("\n");
+	if (!stale || composed) return [head, "Hooks reloaded."].join("\n");
+	return [
+		head,
+		"Hooks reloaded. Extensions are fixed at launch, so for those:",
+		`  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`
+	].join("\n");
+}
+function majorModeSummary(picked, layers, current, composed = false) {
+	const contents = `Major mode ${picked}: ${layers.join(", ") || CORE_ONLY}`;
+	if (picked !== current && !composed) return [contents, `${RELAUNCH}\n  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join("\n");
+	if (picked !== current) return contents;
+	return [contents, "Already using this major mode."].join("\n");
+}
+//#endregion
+export { majorModeSummary as a, majorModeOptionLabel as i, applySummary as n, optionName as o, majorModeItems as r, MAJOR_MODE_COMMAND as t };
+
+//# sourceMappingURL=majorModeText-DuWMOhxX.mjs.map

package/dist/majorModeText-DuWMOhxX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"majorModeText-DuWMOhxX.mjs","names":[],"sources":["../src/services/majorModeText/index.ts"],"sourcesContent":["import type { MajorModesConfig } from '@agimon-ai/po-config/majorModes';\nimport type { TransitionExecutionStrategy } from '@agimon-ai/po-core/transition';\n\nconst OPTION_PREFIX = /^\\[[ x]\\] /;\nconst CORE_ONLY = 'core only';\nconst MARK_ON = '[x]';\nconst MARK_OFF = '[ ]';\nconst RELAUNCH = 'Relaunch with:';\nconst MAJOR_MODE_OPTION = '--major-mode';\ninterface SelectItem {\n  value: string;\n  label: string;\n  description?: string;\n}\n\nexport const MAJOR_MODE_COMMAND = 'mode';\n\n/** Picker rows show the resolved layers while retaining bare major mode values. */\nexport function majorModeItems(config: MajorModesConfig, names: string[]): SelectItem[] {\n  return names.map((name) => ({\n    value: name,\n    label: name,\n    description: config.majorMode[name]?.description ?? CORE_ONLY,\n  }));\n}\n\nexport function majorModeOptionLabel(name: string, layers: string[], current: string): string {\n  return `${name === current ? MARK_ON : MARK_OFF} ${name}: ${layers.join(', ') || CORE_ONLY}`;\n}\n\nexport function optionName(option: string): string {\n  return option.replace(OPTION_PREFIX, '').split(':')[0] ?? option;\n}\n\n/**\n * What a switch actually applied.\n *\n * A synced session composes its extension set on every load, so a reload picks\n * up the new layers outright. A launcher session cannot: Pi freezes the CLI\n * `--extension` list at construction, so a layer that contributes extensions\n * needs a relaunch there and only the hooks change in place.\n */\nexport function applySummary(\n  picked: string,\n  layers: string[],\n  stale: boolean,\n  composed = false,\n  strategy?: TransitionExecutionStrategy,\n  supervised = false,\n): string {\n  const head = `Switched to ${picked}: ${layers.join(', ') || CORE_ONLY}`;\n  if (strategy === 'process-relaunch') {\n    if (supervised) {\n      return `Major mode ${picked} is pending; the supervisor is restarting the agent with it.`;\n    }\n    return [\n      `Major mode ${picked} is pending; the current process remains active.`,\n      `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`,\n    ].join('\\n');\n  }\n  if (strategy === 'pi-reload') return [head, 'Pi reloaded.'].join('\\n');\n  if (!stale || composed) return [head, 'Hooks reloaded.'].join('\\n');\n  return [\n    head,\n    'Hooks reloaded. Extensions are fixed at launch, so for those:',\n    `  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`,\n  ].join('\\n');\n}\n\nexport function majorModeSummary(picked: string, layers: string[], current: string, composed = false): string {\n  const contents = `Major mode ${picked}: ${layers.join(', ') || CORE_ONLY}`;\n  if (picked !== current && !composed) {\n    return [contents, `${RELAUNCH}\\n  ./pi.sh ${MAJOR_MODE_OPTION} ${picked}`].join('\\n');\n  }\n  if (picked !== current) return contents;\n  return [contents, 'Already using this major mode.'].join('\\n');\n}\n\nexport function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"],"mappings":";AAGA,MAAM,gBAAgB;AACtB,MAAM,YAAY;AAClB,MAAM,UAAU;AAChB,MAAM,WAAW;AACjB,MAAM,WAAW;AACjB,MAAM,oBAAoB;AAO1B,MAAa,qBAAqB;;AAGlC,SAAgB,eAAe,QAA0B,OAA+B;CACtF,OAAO,MAAM,KAAK,UAAU;EAC1B,OAAO;EACP,OAAO;EACP,aAAa,OAAO,UAAU,KAAK,EAAE,eAAe;CACtD,EAAE;AACJ;AAEA,SAAgB,qBAAqB,MAAc,QAAkB,SAAyB;CAC5F,OAAO,GAAG,SAAS,UAAU,UAAU,SAAS,GAAG,KAAK,IAAI,OAAO,KAAK,IAAI,KAAK;AACnF;AAEA,SAAgB,WAAW,QAAwB;CACjD,OAAO,OAAO,QAAQ,eAAe,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM;AAC5D;;;;;;;;;AAUA,SAAgB,aACd,QACA,QACA,OACA,WAAW,OACX,UACA,aAAa,OACL;CACR,MAAM,OAAO,eAAe,OAAO,IAAI,OAAO,KAAK,IAAI,KAAK;CAC5D,IAAI,aAAa,oBAAoB;EACnC,IAAI,YACF,OAAO,cAAc,OAAO;EAE9B,OAAO,CACL,cAAc,OAAO,mDACrB,aAAa,kBAAkB,GAAG,QACpC,CAAC,CAAC,KAAK,IAAI;CACb;CACA,IAAI,aAAa,aAAa,OAAO,CAAC,MAAM,cAAc,CAAC,CAAC,KAAK,IAAI;CACrE,IAAI,CAAC,SAAS,UAAU,OAAO,CAAC,MAAM,iBAAiB,CAAC,CAAC,KAAK,IAAI;CAClE,OAAO;EACL;EACA;EACA,aAAa,kBAAkB,GAAG;CACpC,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAgB,iBAAiB,QAAgB,QAAkB,SAAiB,WAAW,OAAe;CAC5G,MAAM,WAAW,cAAc,OAAO,IAAI,OAAO,KAAK,IAAI,KAAK;CAC/D,IAAI,WAAW,WAAW,CAAC,UACzB,OAAO,CAAC,UAAU,GAAG,SAAS,cAAc,kBAAkB,GAAG,QAAQ,CAAC,CAAC,KAAK,IAAI;CAEtF,IAAI,WAAW,SAAS,OAAO;CAC/B,OAAO,CAAC,UAAU,gCAAgC,CAAC,CAAC,KAAK,IAAI;AAC/D"}

package/llms.txt

@@ -0,0 +1,12 @@
+# Doom Pi Major Mode
+
+Named major-mode selection for Doom Pi sessions.
+
+## How to author
+
+- [Author Po major modes](./src/prompts/po-author-major-mode/SKILL.md): Edit `modes.yaml` safely.
+- [`modes.yaml` authoring contract](./src/prompts/po-author-major-mode/references/modes-contract.md): Source precedence, schema, resolution, and verification details.
+
+## Package reference
+
+- [Package README](./README.md): The `/mode` command, the `major_mode` voice tool, and how a mode resolves to layers.

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@agimon-ai/po-major-mode",
+  "version": "0.0.0-alpha.0",
+  "description": "Named major-mode selection and layer composition switching for Po sessions.",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "layer-composition",
+    "major-mode",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "po",
+    "session-reload"
+  ],
+  "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-major-mode"
+  },
+  "files": [
+    "dist",
+    "llms.txt",
+    "src/prompts",
+    "README.md",
+    "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"
+    },
+    "./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-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": {
+    "@earendil-works/pi-coding-agent": "1.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "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"
+    }
+  },
+  "scripts": {
+    "build": "tsdown && pnpm build:mcp",
+    "build:mcp": "tsdown --config tsdown.mcp.config.ts",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint . && oxfmt . --check",
+    "fixcode": "oxlint . --fix && oxfmt ."
+  }
+}

package/src/prompts/po-author-major-mode/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: po-author-major-mode
+description: Configure Po default packages, layers, extensions, hook groups, and named major modes. Use when creating or editing ~/.po/modes.yaml or a repository's .po/modes.yaml, choosing a default mode, or diagnosing which behavior a mode activates.
+---
+
+# Author Po major modes
+
+Use `modes.yaml` only for runtime composition. Major modes choose ordered layers, and layers choose
+Pi extensions, extension packages, and hook groups. Domains configure plugin content and MCP access;
+profiles configure personas and environment defaults.
+
+## Workflow
+
+1. Read both `~/.po/modes.yaml` and the repository's `.po/modes.yaml` when they exist.
+2. Decide whether the change belongs in the personal defaults or only in the current repository.
+3. Preserve unrelated definitions and authored array order.
+4. Put unconditional packages in `default.packages`, reusable behavior in `layers`, and selections
+   under `majorMode`.
+5. Write new modes as mappings with a useful `description` and an ordered `layers` array.
+6. Put package-owned settings under that package's `config` mapping. Do not add layer-level `config`
+   or the removed `targets` field.
+7. Check the result with `po --major-mode <name> --explain`. Use `po sync --check` when the
+   change affects installed packages or the synchronized matrix.
+
+Relative local paths resolve from the repository root for repository configuration and from
+`~/.po` for personal configuration. A repository definition replaces a personal definition
+of the same name as a whole value, so never assume nested fields merge.
+
+Read [references/modes-contract.md](references/modes-contract.md) before editing package entries,
+local extension paths, hook-only layers, inherited definitions, or tombstones.

package/src/prompts/po-author-major-mode/references/modes-contract.md

@@ -0,0 +1,152 @@
+# Po `modes.yaml` authoring contract
+
+## Purpose and sources
+
+`modes.yaml` controls the behavior axis of a Po session:
+
+- `default.packages` is the unconditional package baseline.
+- `layers` are reusable ordered bundles of extensions, packages, and hook groups.
+- `majorMode` maps a session mode to an ordered list of layer names.
+- `defaultMajorMode` selects the starting mode when no flag or inherited environment value wins.
+
+Po reads `~/.po/modes.yaml` first and `<repoRoot>/.po/modes.yaml` second. Either file may
+stand alone. A missing or empty file contributes nothing.
+
+Named `layers` and `majorMode` entries merge by name. A repository entry replaces the complete
+personal entry with the same name. Setting an inherited layer or mode to `null` removes it. The
+top-level `default` block is also replaced as a whole when the repository declares it. An omitted
+repository `default` keeps the personal definition. `defaultMajorMode` uses the last declared value.
+
+Relative paths retain the source that declared them:
+
+- Personal paths resolve from `~/.po`.
+- Repository paths resolve from the repository root, not from `<repoRoot>/.po`.
+
+## Supported shape
+
+```yaml
+# Optional package baseline loaded before every selected named layer.
+default:
+  packages:
+    - '@agimon-ai/po-help'
+    - name: '@scope/optional-extension'
+      optional: true
+      config:
+        policy: concise
+
+layers:
+  local-review:
+    extensions:
+      - './extensions/review.ts'
+    packages:
+      - '@scope/review-extension'
+    hookGroups: [repository]
+  team:
+    packages:
+      - name: '@agimon-ai/po-team'
+        config:
+          models:
+            - model: provider/model-id
+              thinking: high
+
+defaultMajorMode: copilot
+majorMode:
+  minimal:
+    description: Small sessions with delegation only.
+    layers: [team]
+  copilot:
+    description: General coding with delegation and local review policy.
+    layers: [team, local-review]
+```
+
+Treat the `default` example as a shape, not as the current distribution package list. Preserve the
+baseline emitted by `po init` unless the user explicitly wants to replace it. If neither source
+declares `default`, Po adds no fallback feature package set. `default.packages: []` deliberately
+selects an empty baseline. Fixed core packages remain active independently.
+
+### `default`
+
+`default` accepts exactly one field, `packages`, and `packages` must be an array. It does not accept
+`extensions` or `hookGroups`. Its packages activate before packages from selected named layers.
+
+### `layers`
+
+Each layer is a mapping with these supported fields:
+
+- `extensions`: an array of non-empty strings. A bare name selects a Po built-in extension.
+  A `./` or `../` path, or an absolute path, selects a Pi-compatible script or extension directory.
+- `packages`: an array of package strings or package mappings. A normal npm package activates its
+  ordered `package.json` `pi.extensions` entries. An exported subpath can select one adapter.
+  Path-like packages are supported for local unpublished Pi packages.
+- `hookGroups`: an array of hook group IDs contributed by the layer. Duplicate group IDs are
+  removed while retaining first-seen order.
+
+A package mapping accepts only:
+
+- `name`: required non-empty package specifier or local path.
+- `optional`: optional boolean. A missing optional package is skipped and is not installed.
+- `config`: optional mapping owned and interpreted by that package. Its contents stay opaque to the
+  major-mode parser.
+
+Required npm packages missing from the active baseline or selected layers can be installed during
+launch. `po sync` considers required packages from the baseline and every declared layer.
+Optional packages and local paths are not installed automatically.
+
+Package configuration belongs inside its package mapping. Layer-level `config` is rejected because
+there is no unambiguous owner. The removed `targets` field is also rejected. Select a layer by naming
+it from the appropriate major modes.
+
+When hooks are disabled for a run, any selected layer with one or more `hookGroups` is suppressed as
+a whole. Its extension and package entries are suppressed too. Keep unrelated packages out of a
+hook-only layer if they must remain active when hooks are off.
+
+### `majorMode` and `defaultMajorMode`
+
+New major modes use this mapping form:
+
+```yaml
+majorMode:
+  review:
+    description: Focused review with repository policy and Team delegation.
+    layers: [team, local-review]
+```
+
+`description` must be a non-empty string and `layers` must be an array of non-empty layer names.
+Every referenced layer must survive source merging. Layer order and repeated entries are preserved.
+The array-only compatibility form, such as `review: [team, local-review]`, is accepted and receives a
+generated description, but new configuration should use the mapping form.
+
+When `defaultMajorMode` is explicitly configured, it must name a surviving mode. If no source
+declares it, Po uses the compatible `copilot` fallback. Declare an explicit default when the
+available modes do not include `copilot`.
+
+## Safe changes
+
+- Add a package to an existing layer when it should follow that layer's activation and ownership.
+- Add a new layer when the behavior should be reusable across multiple modes or independently
+  ordered.
+- Add a new mode by composing existing layers, then add new layers only for missing behavior.
+- Use a repository replacement when a shared personal definition is unsuitable for one repository.
+- Use `null` only to remove an inherited named layer or named mode. Do not use it as a package entry
+  or as a partial-field deletion mechanism.
+- Keep local paths within trusted, reviewable locations and confirm they resolve from the declaring
+  source's base directory.
+
+## Verification
+
+Run a read-only resolution before launching:
+
+```sh
+po --major-mode review --explain
+```
+
+Confirm the reported major mode, ordered layers, hook groups, and resulting resources. If packages
+or synchronized composition changed, check drift and missing packages without updating artifacts:
+
+```sh
+po sync --check
+```
+
+Run `po sync` only when the user intends to install packages or refresh synchronized artifacts.
+For repository changes to the parser or templates themselves, run the affected Doom Config and
+Po lint, typecheck, build, and test targets.