@agimon-ai/doompi-model-guidance 0.0.1-alpha.101

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,104 @@
+# @agimon-ai/doompi-model-guidance
+
+Per-model system prompt guidance for Pi agents, layered across global and repository scope.
+
+A new model release often needs prompt adjustments that older models do not.
+This package keeps those adjustments in one place, keyed by model id, instead of
+spreading them through every package's prompt.
+
+## Configuration
+
+Listing the package in `modes.yaml` activates its built-in `default` preset. The
+preset currently supplies guidance for `gpt-6-astra` to continue agreed plans and
+scoped tasks without pausing for minor decisions.
+
+Custom guidance lives in `model-guidance.yaml`, read from two scopes:
+
+| Scope      | Path                                     |
+| ---------- | ---------------------------------------- |
+| Global     | `~/.pi/.doom/model-guidance.yaml`        |
+| Repository | `<repository>/.doom/model-guidance.yaml` |
+
+```yaml
+modelGuidance:
+  claude-opus-5: |
+    Keep the task focused. Never go off rails.
+  gpt-6-astra: |
+    Prefer fewer, larger tool batches.
+```
+
+### Matching
+
+Model ids match exactly, against the id Pi reports for the active model. Use the
+value shown by `/model`. A model with no custom entry uses its built-in preset
+entry when one exists; otherwise it gets no guidance.
+
+Exact matching is deliberate: it keeps the file honest about which model a piece
+of text was written for. The cost is that a provider shipping a new versioned id
+needs a new entry.
+
+### Merge rule
+
+The built-in preset applies first. Global guidance overrides the preset one model
+id at a time, then repository guidance overrides global guidance the same way.
+
+| Model id        | Global          | Repository            | Result                |
+| --------------- | --------------- | --------------------- | --------------------- |
+| `claude-opus-5` | "Stay focused." | "Cordis rules apply." | "Cordis rules apply." |
+| `gpt-6-astra`   | "Batch tools."  | absent                | "Batch tools."        |
+| `local-qwen-3`  | absent          | "Short answers only." | "Short answers only." |
+
+A malformed or unreadable guidance file warns on stderr and falls back to the
+built-in preset rather than ending the session.
+
+## Activation
+
+The package ships in the `llm` layer and is optional.
+
+Mode-scoped, in `.doom/modes.yaml`:
+
+```yaml
+layers:
+  llm:
+    packages:
+      - '@agimon-ai/doompi-model-guidance'
+
+majorMode:
+  copilot:
+    layers: [team, ask-user, task, sandbox, llm]
+```
+
+Always on, by listing it in the `default` package list instead:
+
+```yaml
+default:
+  packages:
+    - '@agimon-ai/doompi-model-guidance'
+```
+
+A bare package entry automatically uses the built-in `default` preset. A layer
+only activates when the selected major mode lists it, so add `llm` to every major
+mode that should carry guidance. The top-level `default` route enables it for all
+modes.
+
+## Behaviour
+
+Guidance is appended to the system prompt at the start of each turn, after the
+default packages have contributed and before the profile persona. The file is
+read per turn, so an edit takes effect on the next message with no restart.
+
+## Development
+
+```bash
+pnpm nx run @agimon-ai/doompi-model-guidance:lint
+pnpm nx run @agimon-ai/doompi-model-guidance:typecheck
+pnpm nx run @agimon-ai/doompi-model-guidance:build
+pnpm nx run @agimon-ai/doompi-model-guidance:test
+```
+
+Pi entrypoint: `./dist/extensions/pi.mjs`.
+
+The Pi and server declarations live in `src/extensions` and build directly to
+`/extensions/pi` and `/extensions/server`. Controllers handle host events and call the
+named guidance services. Flat root exports expose guidance loading, merging, and types.
+The shared helpers own registration and cleanup; this stateless plugin needs no lifecycle hooks.

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/doompi-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/doompi-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,gDAAeA,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/doompi-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/doompi-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_doompi_core_mcpFacet = require("@agimon-ai/doompi-core/mcpFacet");
+let _agimon_ai_doompi_core_serverFacet = require("@agimon-ai/doompi-core/serverFacet");
+//#region src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.mcp.ts
+var doompi_use_model_guidance_mcp_default = (0, _agimon_ai_doompi_core_mcpFacet.defineMcpSkill)({
+	name: "doompi-use-model-guidance",
+	description: "Use @agimon-ai/doompi-model-guidance: per-model system prompt guidance, layered across global and repository scope",
+	read: () => (0, _agimon_ai_doompi_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/doompi-use-model-guidance/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = (0, _agimon_ai_doompi_core_mcpFacet.defineMcpPlugin)({
+	name: "@agimon-ai/doompi-model-guidance",
+	session: (context) => ({ get skills() {
+		return [at(doompi_use_model_guidance_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","skillDoompiUseModelGuidance"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/doompi-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'doompi-use-model-guidance',\n  description:\n    'Use @agimon-ai/doompi-model-guidance: per-model system prompt guidance, layered across global and repository scope',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-use-model-guidance/SKILL.md'),\n});\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/doompi-core/mcpFacet';\n\nimport skillDoompiUseModelGuidance from '../src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.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/doompi-model-guidance',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillDoompiUseModelGuidance, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;;;;;AAGA,IAAA,yCAAA,GAAeA,gCAAAA,eAAAA,CAAe;CAC5B,MAAM;CACN,aACE;CACF,aAAA,GAAYC,mCAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,gDAAgD;AACnG,CAAC;;;ACFD,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,OAAA,GAAMC,gCAAAA,gBAAAA,CAAgB;CACjC,MAAM;CACN,UAAU,aAAa,EACrB,IAAI,SAAyC;EAAE,OAAO,CAAC,GAAGC,uCAA6B,OAAO,CAAC;CAAG,EACpG;AACF,CAAC"}

package/dist/extensions/mcp.d.mts

@@ -0,0 +1,5 @@
+//#region generated/mcp.d.ts
+export declare const mcp: import("@agimon-ai/doompi-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,+CAAG"}

package/dist/extensions/mcp.mjs

@@ -0,0 +1,21 @@
+import { defineMcpPlugin, defineMcpSkill } from "@agimon-ai/doompi-core/mcpFacet";
+import { readPackageResource } from "@agimon-ai/doompi-core/serverFacet";
+//#region src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.mcp.ts
+var doompi_use_model_guidance_mcp_default = defineMcpSkill({
+	name: "doompi-use-model-guidance",
+	description: "Use @agimon-ai/doompi-model-guidance: per-model system prompt guidance, layered across global and repository scope",
+	read: () => readPackageResource(import.meta.url, "src/prompts/doompi-use-model-guidance/SKILL.md")
+});
+//#endregion
+//#region generated/mcp.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const mcp = defineMcpPlugin({
+	name: "@agimon-ai/doompi-model-guidance",
+	session: (context) => ({ get skills() {
+		return [at(doompi_use_model_guidance_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":["skillDoompiUseModelGuidance"],"sources":["../../src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.mcp.ts","../../generated/mcp.ts"],"sourcesContent":["import { defineMcpSkill } from '@agimon-ai/doompi-core/mcpFacet';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default defineMcpSkill({\n  name: 'doompi-use-model-guidance',\n  description:\n    'Use @agimon-ai/doompi-model-guidance: per-model system prompt guidance, layered across global and repository scope',\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-use-model-guidance/SKILL.md'),\n});\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineMcpPlugin, type DoomMcpSessionPlugin } from '@agimon-ai/doompi-core/mcpFacet';\n\nimport skillDoompiUseModelGuidance from '../src/extensions/workspaces/sessions/(backend)/skill/doompi-use-model-guidance.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/doompi-model-guidance',\n  session: (context) => ({\n    get skills(): DoomMcpSessionPlugin['skills'] { return [at(skillDoompiUseModelGuidance, context)]; },\n  }) satisfies DoomMcpSessionPlugin,\n});\n\nexport default mcp;\n"],"mappings":";;;AAGA,IAAA,wCAAe,eAAe;CAC5B,MAAM;CACN,aACE;CACF,YAAY,oBAAoB,YAAY,KAAK,gDAAgD;AACnG,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,uCAA6B,OAAO,CAAC;CAAG,EACpG;AACF,CAAC"}

package/dist/extensions/pi.cjs

@@ -0,0 +1,61 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+const require_modelGuidanceStore = require("../modelGuidanceStore-DEs_jtoI.cjs");
+let _agimon_ai_doompi_core_piExtension = require("@agimon-ai/doompi-core/piExtension");
+let _agimon_ai_doompi_core_extensionFile = require("@agimon-ai/doompi-core/extensionFile");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
+//#region src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.cli.ts
+/** Read each turn so configuration edits take effect without restarting the session. */
+const modelGuidanceEvents = { before_agent_start(event, context) {
+	const modelId = context.model?.id;
+	if (!modelId) return void 0;
+	let root = node_path.default.resolve(context.cwd);
+	while (!node_fs.default.existsSync(node_path.default.join(root, ".git")) && !node_fs.default.existsSync(node_path.default.join(root, ".doom"))) {
+		const parent = node_path.default.dirname(root);
+		if (parent === root) break;
+		root = parent;
+	}
+	const guidance = require_modelGuidanceStore.guidanceForModel(require_modelGuidanceStore.loadModelGuidance(root), modelId);
+	const systemPrompt = require_modelGuidanceStore.applyModelGuidance(event.systemPrompt, guidance);
+	return systemPrompt ? { systemPrompt } : void 0;
+} };
+var beforeAgentStart_cli_default$1 = (_context) => (...args) => modelGuidanceEvents.before_agent_start(...args);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli.ts
+var beforeAgentStart_cli_default = (0, _agimon_ai_doompi_core_extensionFile.defineCliHook)(beforeAgentStart_cli_default$1);
+//#endregion
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = (0, _agimon_ai_doompi_core_piExtension.definePiExtension)("@agimon-ai/doompi-model-guidance", (context) => ({ events: { before_agent_start: at(beforeAgentStart_cli_default, context) } }));
+//#endregion
+exports.default = extension;
+exports.extension = extension;
+
+//# sourceMappingURL=pi.cjs.map

package/dist/extensions/pi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.cjs","names":["path","fs","guidanceForModel","loadModelGuidance","applyModelGuidance","defineCliHook","contribution","definePiExtension","hookBeforeAgentStart"],"sources":["../../src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.cli.ts","../../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli.ts","../../generated/pi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PiEventHandlers, PiPluginContext } from '@agimon-ai/doompi-core/piExtension';\n\nimport { applyModelGuidance, guidanceForModel } from '../../../../../../services/modelGuidance';\nimport { loadModelGuidance } from '../../../../../../services/modelGuidanceStore';\n\n/** Read each turn so configuration edits take effect without restarting the session. */\nexport const modelGuidanceEvents = {\n  before_agent_start(event, context) {\n    const modelId = context.model?.id;\n    if (!modelId) return undefined;\n    let root = path.resolve(context.cwd);\n    while (!fs.existsSync(path.join(root, '.git')) && !fs.existsSync(path.join(root, '.doom'))) {\n      const parent = path.dirname(root);\n      if (parent === root) break;\n      root = parent;\n    }\n    const guidance = guidanceForModel(loadModelGuidance(root), modelId);\n    const systemPrompt = applyModelGuidance(event.systemPrompt, guidance);\n    return systemPrompt ? { systemPrompt } : undefined;\n  },\n} satisfies PiEventHandlers;\n\nexport default (_context: PiPluginContext) =>\n  (...args: Parameters<typeof modelGuidanceEvents.before_agent_start>) =>\n    modelGuidanceEvents.before_agent_start(...args);\n","import { defineCliHook } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/beforeAgentStart.cli';\n\nexport default defineCliHook(contribution);\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { definePiExtension, type PiPluginContext, type PiPluginContributions } from '@agimon-ai/doompi-core/piExtension';\n\nimport hookBeforeAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli';\n\ntype OptionsOf<T> = T extends (context: PiPluginContext<infer Options>) => unknown ? Options : never;\ntype InferredOptions = Exclude<OptionsOf<typeof hookBeforeAgentStart>, undefined>;\ntype Intersect<Union> =\n  (Union extends unknown ? (value: Union) => void : never) extends (value: infer Value) => void ? Value : never;\ntype ExtensionOptions = [InferredOptions] extends [never] ? undefined : Intersect<InferredOptions>;\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 extension = definePiExtension<ExtensionOptions>('@agimon-ai/doompi-model-guidance', (context) => ({\n  events: {\n    before_agent_start: at(hookBeforeAgentStart, context) as NonNullable<PiPluginContributions['events']>['before_agent_start'],\n  },\n}));\n\nexport default extension;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,MAAa,sBAAsB,EACjC,mBAAmB,OAAO,SAAS;CACjC,MAAM,UAAU,QAAQ,OAAO;CAC/B,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,OAAOA,UAAAA,QAAK,QAAQ,QAAQ,GAAG;CACnC,OAAO,CAACC,QAAAA,QAAG,WAAWD,UAAAA,QAAK,KAAK,MAAM,MAAM,CAAC,KAAK,CAACC,QAAAA,QAAG,WAAWD,UAAAA,QAAK,KAAK,MAAM,OAAO,CAAC,GAAG;EAC1F,MAAM,SAASA,UAAAA,QAAK,QAAQ,IAAI;EAChC,IAAI,WAAW,MAAM;EACrB,OAAO;CACT;CACA,MAAM,WAAWE,2BAAAA,iBAAiBC,2BAAAA,kBAAkB,IAAI,GAAG,OAAO;CAClE,MAAM,eAAeC,2BAAAA,mBAAmB,MAAM,cAAc,QAAQ;CACpE,OAAO,eAAe,EAAE,aAAa,IAAI,KAAA;AAC3C,EACF;AAEA,IAAA,kCAAgB,cACb,GAAG,SACF,oBAAoB,mBAAmB,GAAG,IAAI;;;ACvBlD,IAAA,gCAAA,GAAeC,qCAAAA,cAAAA,CAAcC,8BAAY;;;ACQzC,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,aAAA,GAAYC,mCAAAA,kBAAAA,CAAoC,qCAAqC,aAAa,EAC7G,QAAQ,EACN,oBAAoB,GAAGC,8BAAsB,OAAO,EACtD,EACF,EAAE"}

package/dist/extensions/pi.d.mts

@@ -0,0 +1,5 @@
+//#region generated/pi.d.ts
+export declare const extension: import("@agimon-ai/doompi-core/runtimePiExtension").DefinedPiExtension<undefined>;
+//#endregion
+export { extension as default };
+//# sourceMappingURL=pi.d.mts.map

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

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

package/dist/extensions/pi.mjs

@@ -0,0 +1,32 @@
+import { i as guidanceForModel, n as loadModelGuidance, r as applyModelGuidance } from "../modelGuidanceStore-BPKgawjz.mjs";
+import { definePiExtension } from "@agimon-ai/doompi-core/piExtension";
+import { defineCliHook } from "@agimon-ai/doompi-core/extensionFile";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.cli.ts
+/** Read each turn so configuration edits take effect without restarting the session. */
+const modelGuidanceEvents = { before_agent_start(event, context) {
+	const modelId = context.model?.id;
+	if (!modelId) return void 0;
+	let root = path.resolve(context.cwd);
+	while (!fs.existsSync(path.join(root, ".git")) && !fs.existsSync(path.join(root, ".doom"))) {
+		const parent = path.dirname(root);
+		if (parent === root) break;
+		root = parent;
+	}
+	const guidance = guidanceForModel(loadModelGuidance(root), modelId);
+	const systemPrompt = applyModelGuidance(event.systemPrompt, guidance);
+	return systemPrompt ? { systemPrompt } : void 0;
+} };
+var beforeAgentStart_cli_default$1 = (_context) => (...args) => modelGuidanceEvents.before_agent_start(...args);
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli.ts
+var beforeAgentStart_cli_default = defineCliHook(beforeAgentStart_cli_default$1);
+//#endregion
+//#region generated/pi.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const extension = definePiExtension("@agimon-ai/doompi-model-guidance", (context) => ({ events: { before_agent_start: at(beforeAgentStart_cli_default, context) } }));
+//#endregion
+export { extension as default, extension };
+
+//# sourceMappingURL=pi.mjs.map

package/dist/extensions/pi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.mjs","names":["contribution","hookBeforeAgentStart"],"sources":["../../src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.cli.ts","../../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli.ts","../../generated/pi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PiEventHandlers, PiPluginContext } from '@agimon-ai/doompi-core/piExtension';\n\nimport { applyModelGuidance, guidanceForModel } from '../../../../../../services/modelGuidance';\nimport { loadModelGuidance } from '../../../../../../services/modelGuidanceStore';\n\n/** Read each turn so configuration edits take effect without restarting the session. */\nexport const modelGuidanceEvents = {\n  before_agent_start(event, context) {\n    const modelId = context.model?.id;\n    if (!modelId) return undefined;\n    let root = path.resolve(context.cwd);\n    while (!fs.existsSync(path.join(root, '.git')) && !fs.existsSync(path.join(root, '.doom'))) {\n      const parent = path.dirname(root);\n      if (parent === root) break;\n      root = parent;\n    }\n    const guidance = guidanceForModel(loadModelGuidance(root), modelId);\n    const systemPrompt = applyModelGuidance(event.systemPrompt, guidance);\n    return systemPrompt ? { systemPrompt } : undefined;\n  },\n} satisfies PiEventHandlers;\n\nexport default (_context: PiPluginContext) =>\n  (...args: Parameters<typeof modelGuidanceEvents.before_agent_start>) =>\n    modelGuidanceEvents.before_agent_start(...args);\n","import { defineCliHook } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/beforeAgentStart.cli';\n\nexport default defineCliHook(contribution);\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { definePiExtension, type PiPluginContext, type PiPluginContributions } from '@agimon-ai/doompi-core/piExtension';\n\nimport hookBeforeAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.cli';\n\ntype OptionsOf<T> = T extends (context: PiPluginContext<infer Options>) => unknown ? Options : never;\ntype InferredOptions = Exclude<OptionsOf<typeof hookBeforeAgentStart>, undefined>;\ntype Intersect<Union> =\n  (Union extends unknown ? (value: Union) => void : never) extends (value: infer Value) => void ? Value : never;\ntype ExtensionOptions = [InferredOptions] extends [never] ? undefined : Intersect<InferredOptions>;\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 extension = definePiExtension<ExtensionOptions>('@agimon-ai/doompi-model-guidance', (context) => ({\n  events: {\n    before_agent_start: at(hookBeforeAgentStart, context) as NonNullable<PiPluginContributions['events']>['before_agent_start'],\n  },\n}));\n\nexport default extension;\n"],"mappings":";;;;;;;AASA,MAAa,sBAAsB,EACjC,mBAAmB,OAAO,SAAS;CACjC,MAAM,UAAU,QAAQ,OAAO;CAC/B,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,OAAO,KAAK,QAAQ,QAAQ,GAAG;CACnC,OAAO,CAAC,GAAG,WAAW,KAAK,KAAK,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,KAAK,MAAM,OAAO,CAAC,GAAG;EAC1F,MAAM,SAAS,KAAK,QAAQ,IAAI;EAChC,IAAI,WAAW,MAAM;EACrB,OAAO;CACT;CACA,MAAM,WAAW,iBAAiB,kBAAkB,IAAI,GAAG,OAAO;CAClE,MAAM,eAAe,mBAAmB,MAAM,cAAc,QAAQ;CACpE,OAAO,eAAe,EAAE,aAAa,IAAI,KAAA;AAC3C,EACF;AAEA,IAAA,kCAAgB,cACb,GAAG,SACF,oBAAoB,mBAAmB,GAAG,IAAI;;;ACvBlD,IAAA,+BAAe,cAAcA,8BAAY;;;ACQzC,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AAEpE,MAAa,YAAY,kBAAoC,qCAAqC,aAAa,EAC7G,QAAQ,EACN,oBAAoB,GAAGC,8BAAsB,OAAO,EACtD,EACF,EAAE"}

package/dist/extensions/server.cjs

@@ -0,0 +1,68 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_modelGuidanceStore = require("../modelGuidanceStore-DEs_jtoI.cjs");
+let _agimon_ai_doompi_core_extensionFile = require("@agimon-ai/doompi-core/extensionFile");
+let _agimon_ai_doompi_core_serverFacet = require("@agimon-ai/doompi-core/serverFacet");
+let _agimon_ai_doompi_core_help = require("@agimon-ai/doompi-core/help");
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server.ts
+var beforeAgentStart_server_default = (0, _agimon_ai_doompi_core_extensionFile.defineHook)({
+	event: "before_agent_start",
+	handle(event, execution) {
+		const modelId = execution.model?.id;
+		if (!modelId) return void 0;
+		const guidance = require_modelGuidanceStore.guidanceForModel(require_modelGuidanceStore.loadModelGuidance(execution.cwd), modelId);
+		const systemPrompt = require_modelGuidanceStore.applyModelGuidance(typeof event.systemPrompt === "string" ? event.systemPrompt : "", guidance);
+		return systemPrompt ? { systemPrompt } : void 0;
+	}
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server.ts
+var doompiModelGuidance_server_default = (0, _agimon_ai_doompi_core_extensionFile.defineResource)({
+	when: {
+		state: { "minor-mode": "help" },
+		attribution: {
+			kind: "minor",
+			mode: "help"
+		}
+	},
+	name: "doompi-model-guidance",
+	kind: "context",
+	read: () => (0, _agimon_ai_doompi_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "llms.txt")
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/_lib/doompiUseModelGuidance.server.ts
+var doompiUseModelGuidance_server_default$1 = {
+	name: "doompi-use-model-guidance",
+	when: _agimon_ai_doompi_core_help.DOOM_HELP_WHEN,
+	kind: "skill",
+	read: () => (0, _agimon_ai_doompi_core_serverFacet.readPackageResource)(require("url").pathToFileURL(__filename).href, "src/prompts/doompi-use-model-guidance/SKILL.md")
+};
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.server.ts
+var doompiUseModelGuidance_server_default = (0, _agimon_ai_doompi_core_extensionFile.defineResource)(doompiUseModelGuidance_server_default$1);
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = (0, _agimon_ai_doompi_core_serverFacet.defineServerPlugin)({
+	name: "@agimon-ai/doompi-model-guidance",
+	session: (context) => ({
+		get hooks() {
+			return [via({ event: "before_agent_start" }, at(beforeAgentStart_server_default, context))];
+		},
+		get resources() {
+			return [at(doompiModelGuidance_server_default, context), at(doompiUseModelGuidance_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":["guidanceForModel","loadModelGuidance","applyModelGuidance","defineHook","contribution","readPackageResource","defineResource","contribution","DOOM_HELP_WHEN","readPackageResource","defineResource","contribution","defineServerPlugin","hookBeforeAgentStart","resourceDoompiModelGuidance","resourceDoompiUseModelGuidance"],"sources":["../../src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/_lib/doompiModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/_lib/doompiUseModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.server.ts","../../generated/server.ts"],"sourcesContent":["import type { DoomHeadlessHook } from '@agimon-ai/doompi-core/headless';\n\nimport { applyModelGuidance, guidanceForModel } from '../../../../../../services/modelGuidance';\nimport { loadModelGuidance } from '../../../../../../services/modelGuidanceStore';\n\nexport const modelGuidanceHook: DoomHeadlessHook = {\n  event: 'before_agent_start',\n  handle(event, execution) {\n    const modelId = execution.model?.id;\n    if (!modelId) return undefined;\n    const guidance = guidanceForModel(loadModelGuidance(execution.cwd), modelId);\n    const systemPrompt = applyModelGuidance(typeof event.systemPrompt === 'string' ? event.systemPrompt : '', guidance);\n    return systemPrompt ? { systemPrompt } : undefined;\n  },\n};\n\nexport default modelGuidanceHook;\n","import { defineHook } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/beforeAgentStart.server';\n\nexport default defineHook(contribution);\n","import { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default {\n  // The package index is Help-catalog material, not standing instruction, so it\n  // only enters the prompt while Help mode is active.\n  when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n  name: 'doompi-model-guidance',\n  kind: 'context' as const,\n  read: () => readPackageResource(import.meta.url, 'llms.txt'),\n};\n","import { defineResource } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/doompiModelGuidance.server';\n\nexport default defineResource(contribution);\n","import { DOOM_HELP_WHEN } from '@agimon-ai/doompi-core/help';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default {\n  name: 'doompi-use-model-guidance',\n  when: DOOM_HELP_WHEN,\n  kind: 'skill' as const,\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-use-model-guidance/SKILL.md'),\n};\n","import { defineResource } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/doompiUseModelGuidance.server';\n\nexport default defineResource(contribution);\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/doompi-core/serverFacet';\n\nimport hookBeforeAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server';\nimport resourceDoompiModelGuidance from '../src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server';\nimport resourceDoompiUseModelGuidance from '../src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.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;\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/doompi-model-guidance',\n  session: (context) => ({\n    get hooks(): DoomServerSessionPlugin['hooks'] { return [via({ event: 'before_agent_start' }, at(hookBeforeAgentStart, context))]; },\n    get resources(): DoomServerSessionPlugin['resources'] { return [at(resourceDoompiModelGuidance, context), at(resourceDoompiUseModelGuidance, context)]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;;;;;ACIA,IAAA,mCAAA,GAAeG,qCAAAA,WAAAA,CAAWC;CDExB,OAAO;CACP,OAAO,OAAO,WAAW;EACvB,MAAM,UAAU,UAAU,OAAO;EACjC,IAAI,CAAC,SAAS,OAAO,KAAA;EACrB,MAAM,WAAWJ,2BAAAA,iBAAiBC,2BAAAA,kBAAkB,UAAU,GAAG,GAAG,OAAO;EAC3E,MAAM,eAAeC,2BAAAA,mBAAmB,OAAO,MAAM,iBAAiB,WAAW,MAAM,eAAe,IAAI,QAAQ;EAClH,OAAO,eAAe,EAAE,aAAa,IAAI,KAAA;CAC3C;ACTwBE,CAAY;;;AEAtC,IAAA,sCAAA,GAAeE,qCAAAA,eAAAA,CAAeC;CDC5B,MAAM;EAAE,OAAO,EAAE,cAAc,OAAO;EAAG,aAAa;GAAE,MAAM;GAAkB,MAAM;EAAO;CAAE;CAC/F,MAAM;CACN,MAAM;CACN,aAAA,GAAYF,mCAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,UAAU;ACJ/BE,CAAY;;;ACD1C,IAAA,0CAAe;CACb,MAAM;CACN,MAAMC,4BAAAA;CACN,MAAM;CACN,aAAA,GAAYC,mCAAAA,oBAAAA,CAAAA,QAAAA,KAAAA,CAAAA,CAAAA,cAAAA,UAAAA,CAAAA,CAAAA,MAAqC,gDAAgD;AACnG;;;ACJA,IAAA,yCAAA,GAAeC,qCAAAA,eAAAA,CAAeC,uCAAY;;;ACI1C,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,MAAM,OAAU,UAAmC,UAChD,UAAU,KAAA,IAAY,KAAA,IAAY;CAAE,GAAG;CAAU,GAAI;AAAiB;AAEzE,MAAa,SAAA,GAAQC,mCAAAA,mBAAAA,CAAmB;CACtC,MAAM;CACN,UAAU,aAAa;EACrB,IAAI,QAA0C;GAAE,OAAO,CAAC,IAAI,EAAE,OAAO,qBAAqB,GAAG,GAAGC,iCAAsB,OAAO,CAAC,CAAC;EAAG;EAClI,IAAI,YAAkD;GAAE,OAAO,CAAC,GAAGC,oCAA6B,OAAO,GAAG,GAAGC,uCAAgC,OAAO,CAAC;EAAG;CAC1J;AACF,CAAC"}

package/dist/extensions/server.d.mts

@@ -0,0 +1,5 @@
+//#region generated/server.d.ts
+export declare const facet: import("@agimon-ai/doompi-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":";qBAaa,oDAAK"}

package/dist/extensions/server.mjs

@@ -0,0 +1,60 @@
+import { i as guidanceForModel, n as loadModelGuidance, r as applyModelGuidance } from "../modelGuidanceStore-BPKgawjz.mjs";
+import { defineHook, defineResource } from "@agimon-ai/doompi-core/extensionFile";
+import { defineServerPlugin, readPackageResource } from "@agimon-ai/doompi-core/serverFacet";
+import { DOOM_HELP_WHEN } from "@agimon-ai/doompi-core/help";
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server.ts
+var beforeAgentStart_server_default = defineHook({
+	event: "before_agent_start",
+	handle(event, execution) {
+		const modelId = execution.model?.id;
+		if (!modelId) return void 0;
+		const guidance = guidanceForModel(loadModelGuidance(execution.cwd), modelId);
+		const systemPrompt = applyModelGuidance(typeof event.systemPrompt === "string" ? event.systemPrompt : "", guidance);
+		return systemPrompt ? { systemPrompt } : void 0;
+	}
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server.ts
+var doompiModelGuidance_server_default = defineResource({
+	when: {
+		state: { "minor-mode": "help" },
+		attribution: {
+			kind: "minor",
+			mode: "help"
+		}
+	},
+	name: "doompi-model-guidance",
+	kind: "context",
+	read: () => readPackageResource(import.meta.url, "llms.txt")
+});
+//#endregion
+//#region src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.server.ts
+var doompiUseModelGuidance_server_default = defineResource({
+	name: "doompi-use-model-guidance",
+	when: DOOM_HELP_WHEN,
+	kind: "skill",
+	read: () => readPackageResource(import.meta.url, "src/prompts/doompi-use-model-guidance/SKILL.md")
+});
+//#endregion
+//#region generated/server.ts
+const at = (value, context) => typeof value === "function" ? value(context) : value;
+const via = (identity, value) => value === void 0 ? void 0 : {
+	...identity,
+	...value
+};
+const facet = defineServerPlugin({
+	name: "@agimon-ai/doompi-model-guidance",
+	session: (context) => ({
+		get hooks() {
+			return [via({ event: "before_agent_start" }, at(beforeAgentStart_server_default, context))];
+		},
+		get resources() {
+			return [at(doompiModelGuidance_server_default, context), at(doompiUseModelGuidance_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":["contribution","contribution","contribution","hookBeforeAgentStart","resourceDoompiModelGuidance","resourceDoompiUseModelGuidance"],"sources":["../../src/extensions/workspaces/sessions/(backend)/hook/_lib/beforeAgentStart.server.ts","../../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/_lib/doompiModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/_lib/doompiUseModelGuidance.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.server.ts","../../generated/server.ts"],"sourcesContent":["import type { DoomHeadlessHook } from '@agimon-ai/doompi-core/headless';\n\nimport { applyModelGuidance, guidanceForModel } from '../../../../../../services/modelGuidance';\nimport { loadModelGuidance } from '../../../../../../services/modelGuidanceStore';\n\nexport const modelGuidanceHook: DoomHeadlessHook = {\n  event: 'before_agent_start',\n  handle(event, execution) {\n    const modelId = execution.model?.id;\n    if (!modelId) return undefined;\n    const guidance = guidanceForModel(loadModelGuidance(execution.cwd), modelId);\n    const systemPrompt = applyModelGuidance(typeof event.systemPrompt === 'string' ? event.systemPrompt : '', guidance);\n    return systemPrompt ? { systemPrompt } : undefined;\n  },\n};\n\nexport default modelGuidanceHook;\n","import { defineHook } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/beforeAgentStart.server';\n\nexport default defineHook(contribution);\n","import { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default {\n  // The package index is Help-catalog material, not standing instruction, so it\n  // only enters the prompt while Help mode is active.\n  when: { state: { 'minor-mode': 'help' }, attribution: { kind: 'minor' as const, mode: 'help' } },\n  name: 'doompi-model-guidance',\n  kind: 'context' as const,\n  read: () => readPackageResource(import.meta.url, 'llms.txt'),\n};\n","import { defineResource } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/doompiModelGuidance.server';\n\nexport default defineResource(contribution);\n","import { DOOM_HELP_WHEN } from '@agimon-ai/doompi-core/help';\nimport { readPackageResource } from '@agimon-ai/doompi-core/serverFacet';\n\nexport default {\n  name: 'doompi-use-model-guidance',\n  when: DOOM_HELP_WHEN,\n  kind: 'skill' as const,\n  read: () => readPackageResource(import.meta.url, 'src/prompts/doompi-use-model-guidance/SKILL.md'),\n};\n","import { defineResource } from '@agimon-ai/doompi-core/extensionFile';\n\nimport contribution from './_lib/doompiUseModelGuidance.server';\n\nexport default defineResource(contribution);\n","// Generated by @agimon-ai/doompi-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/doompi-core/serverFacet';\n\nimport hookBeforeAgentStart from '../src/extensions/workspaces/sessions/(backend)/hook/beforeAgentStart.server';\nimport resourceDoompiModelGuidance from '../src/extensions/workspaces/sessions/(backend)/resource/doompiModelGuidance.server';\nimport resourceDoompiUseModelGuidance from '../src/extensions/workspaces/sessions/(backend)/resource/doompiUseModelGuidance.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;\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/doompi-model-guidance',\n  session: (context) => ({\n    get hooks(): DoomServerSessionPlugin['hooks'] { return [via({ event: 'before_agent_start' }, at(hookBeforeAgentStart, context))]; },\n    get resources(): DoomServerSessionPlugin['resources'] { return [at(resourceDoompiModelGuidance, context), at(resourceDoompiUseModelGuidance, context)]; },\n  }),\n});\n\nexport default facet;\n"],"mappings":";;;;;;ACIA,IAAA,kCAAe,WAAWA;CDExB,OAAO;CACP,OAAO,OAAO,WAAW;EACvB,MAAM,UAAU,UAAU,OAAO;EACjC,IAAI,CAAC,SAAS,OAAO,KAAA;EACrB,MAAM,WAAW,iBAAiB,kBAAkB,UAAU,GAAG,GAAG,OAAO;EAC3E,MAAM,eAAe,mBAAmB,OAAO,MAAM,iBAAiB,WAAW,MAAM,eAAe,IAAI,QAAQ;EAClH,OAAO,eAAe,EAAE,aAAa,IAAI,KAAA;CAC3C;ACTwBA,CAAY;;;AEAtC,IAAA,qCAAe,eAAeC;CDC5B,MAAM;EAAE,OAAO,EAAE,cAAc,OAAO;EAAG,aAAa;GAAE,MAAM;GAAkB,MAAM;EAAO;CAAE;CAC/F,MAAM;CACN,MAAM;CACN,YAAY,oBAAoB,YAAY,KAAK,UAAU;ACJ/BA,CAAY;;;AEA1C,IAAA,wCAAe,eAAeC;CDA5B,MAAM;CACN,MAAM;CACN,MAAM;CACN,YAAY,oBAAoB,YAAY,KAAK,gDAAgD;ACHrEA,CAAY;;;ACI1C,MAAM,MAAY,OAA0B,YAC1C,OAAO,UAAU,aAAc,MAAwB,OAAO,IAAI;AACpE,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,QAA0C;GAAE,OAAO,CAAC,IAAI,EAAE,OAAO,qBAAqB,GAAG,GAAGC,iCAAsB,OAAO,CAAC,CAAC;EAAG;EAClI,IAAI,YAAkD;GAAE,OAAO,CAAC,GAAGC,oCAA6B,OAAO,GAAG,GAAGC,uCAAgC,OAAO,CAAC;EAAG;CAC1J;AACF,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_modelGuidanceStore = require("./modelGuidanceStore-DEs_jtoI.cjs");
+exports.DEFAULT_MODEL_GUIDANCE_PRESET = require_modelGuidanceStore.DEFAULT_MODEL_GUIDANCE_PRESET;
+exports.GUIDANCE_FILE = require_modelGuidanceStore.GUIDANCE_FILE;
+exports.applyModelGuidance = require_modelGuidanceStore.applyModelGuidance;
+exports.guidanceForModel = require_modelGuidanceStore.guidanceForModel;
+exports.loadModelGuidance = require_modelGuidanceStore.loadModelGuidance;
+exports.mergeModelGuidance = require_modelGuidanceStore.mergeModelGuidance;

package/dist/index.d.mts

@@ -0,0 +1,66 @@
+//#region src/types/modelGuidance.d.ts
+/**
+ * Wire and domain shapes for per-model system prompt guidance.
+ *
+ * Document values are `unknown` rather than `string` because a guidance file is
+ * user-authored YAML: the parser cannot promise a string, so the fold narrows
+ * each value instead of asserting one.
+ */
+/** Raw shape of one `.doom/model-guidance.yaml` document. */
+interface ModelGuidanceDocument {
+  readonly modelGuidance?: Readonly<Record<string, unknown>>;
+}
+/** Model id to guidance text, after the global and repository documents are folded. */
+type ModelGuidanceMap = Readonly<Record<string, string>>;
+//#endregion
+//#region src/services/modelGuidanceStore/index.d.ts
+/** Layered guidance document, read from the global then the repository `.doom` directory. */
+export declare const GUIDANCE_FILE = "model-guidance.yaml";
+/**
+ * Reads and folds the global and repository guidance documents.
+ *
+ * Fails open. The reader parses YAML without a guard, so a typo in an optional
+ * prompt file would otherwise throw on every turn of the session. Degrading to
+ * the built-in preset keeps the package useful without letting malformed user
+ * input end the turn.
+ *
+ * `homeDirectory` exists so a test can point the global scope at a temporary
+ * directory; production callers omit it and the reader falls back to the real home.
+ */
+export declare function loadModelGuidance(repositoryRoot: string | undefined, homeDirectory?: string): ModelGuidanceMap;
+//#endregion
+//#region src/constants/modelGuidance.d.ts
+export declare const DEFAULT_MODEL_GUIDANCE_PRESET: {
+  readonly modelGuidance: {
+    readonly 'gpt-6-astra': 'Continue executing an agreed plan and its scoped tasks without pausing for small decisions or repeated confirmation. Treat the accepted plan and task list as authorization to complete the work, make reasonable low-risk and reversible implementation choices, and verify the result. Ask only when blocked or when a decision would materially change scope, requirements, security, data safety, or destructive behavior.';
+  };
+};
+//#endregion
+//#region src/services/modelGuidance/index.d.ts
+/**
+ * Folds guidance documents in source order, so a later document overrides one
+ * model id at a time.
+ *
+ * The reader hands back global then repository, so a repository entry wins the
+ * ids it names while global entries it does not name survive. That per-id
+ * granularity is the point: a personal default stays useful inside a project
+ * that only pins one model.
+ *
+ * Non-string values are dropped rather than rejected, because a guidance file is
+ * optional user input and one bad entry must not discard the rest.
+ */
+export declare function mergeModelGuidance(documents: readonly ModelGuidanceDocument[]): ModelGuidanceMap;
+/** Exact-match lookup. An unknown or absent model id contributes nothing. */
+export declare function guidanceForModel(guidance: ModelGuidanceMap, modelId: string | undefined): string | undefined;
+/**
+ * Builds the replacement system prompt for one turn.
+ *
+ * Pi treats a returned `systemPrompt` as a full replacement and chains handlers,
+ * so the incoming prompt has to be re-embedded. Returning bare guidance would
+ * discard every earlier contribution, including plan mode and the persona.
+ * Keeping that in one function leaves a single place for it to be right.
+ */
+export declare function applyModelGuidance(systemPrompt: string, guidance: string | undefined): string | undefined;
+//#endregion
+export type { ModelGuidanceDocument, ModelGuidanceMap };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/modelGuidance.ts","../src/services/modelGuidanceStore/index.ts","../src/constants/modelGuidance.ts","../src/services/modelGuidance/index.ts"],"mappings":";;;;;;;;;UASiB;WACN,gBAAgB,SAAS;;;KAIxB,mBAAmB,SAAS;;;;qBCP3B;;;;;;;;;;;;wBAaG,kBAAkB,oCAAoC,yBAAyB;;;qBChBlF;WAAkC;aAF3C;;;;;;;;;;;;;;;;;wBCeY,mBAAmB,oBAAoB,0BAA0B;;wBAajE,iBAAiB,UAAU,kBAAkB;;;;;;;;;wBAa7C,mBAAmB,sBAAsB"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as mergeModelGuidance, i as guidanceForModel, n as loadModelGuidance, o as DEFAULT_MODEL_GUIDANCE_PRESET, r as applyModelGuidance, t as GUIDANCE_FILE } from "./modelGuidanceStore-BPKgawjz.mjs";
+export { DEFAULT_MODEL_GUIDANCE_PRESET, GUIDANCE_FILE, applyModelGuidance, guidanceForModel, loadModelGuidance, mergeModelGuidance };

package/dist/modelGuidanceStore-BPKgawjz.mjs

@@ -0,0 +1,76 @@
+import { readDoomConfigSources } from "@agimon-ai/doompi-config/layeredConfig";
+//#region src/constants/modelGuidance.ts
+const DEFAULT_GUIDANCE = { "gpt-6-astra": "Continue executing an agreed plan and its scoped tasks without pausing for small decisions or repeated confirmation. Treat the accepted plan and task list as authorization to complete the work, make reasonable low-risk and reversible implementation choices, and verify the result. Ask only when blocked or when a decision would materially change scope, requirements, security, data safety, or destructive behavior." };
+const DEFAULT_MODEL_GUIDANCE_PRESET = { modelGuidance: DEFAULT_GUIDANCE };
+//#endregion
+//#region src/services/modelGuidance/index.ts
+Object.freeze(DEFAULT_GUIDANCE);
+Object.freeze(DEFAULT_MODEL_GUIDANCE_PRESET);
+/**
+* Folds guidance documents in source order, so a later document overrides one
+* model id at a time.
+*
+* The reader hands back global then repository, so a repository entry wins the
+* ids it names while global entries it does not name survive. That per-id
+* granularity is the point: a personal default stays useful inside a project
+* that only pins one model.
+*
+* Non-string values are dropped rather than rejected, because a guidance file is
+* optional user input and one bad entry must not discard the rest.
+*/
+function mergeModelGuidance(documents) {
+	const merged = {};
+	for (const document of documents) for (const [modelId, guidance] of Object.entries(document.modelGuidance ?? {})) {
+		if (typeof guidance !== "string") continue;
+		const trimmed = guidance.trim();
+		if (trimmed) merged[modelId] = trimmed;
+	}
+	return merged;
+}
+/** Exact-match lookup. An unknown or absent model id contributes nothing. */
+function guidanceForModel(guidance, modelId) {
+	if (!modelId) return void 0;
+	return guidance[modelId];
+}
+/**
+* Builds the replacement system prompt for one turn.
+*
+* Pi treats a returned `systemPrompt` as a full replacement and chains handlers,
+* so the incoming prompt has to be re-embedded. Returning bare guidance would
+* discard every earlier contribution, including plan mode and the persona.
+* Keeping that in one function leaves a single place for it to be right.
+*/
+function applyModelGuidance(systemPrompt, guidance) {
+	if (!guidance) return void 0;
+	return `${systemPrompt}\n\n${guidance}`;
+}
+//#endregion
+//#region src/services/modelGuidanceStore/index.ts
+/** Layered guidance document, read from the global then the repository `.doom` directory. */
+const GUIDANCE_FILE = "model-guidance.yaml";
+/**
+* Reads and folds the global and repository guidance documents.
+*
+* Fails open. The reader parses YAML without a guard, so a typo in an optional
+* prompt file would otherwise throw on every turn of the session. Degrading to
+* the built-in preset keeps the package useful without letting malformed user
+* input end the turn.
+*
+* `homeDirectory` exists so a test can point the global scope at a temporary
+* directory; production callers omit it and the reader falls back to the real home.
+*/
+function loadModelGuidance(repositoryRoot, homeDirectory) {
+	if (!repositoryRoot) return DEFAULT_GUIDANCE;
+	try {
+		const sources = readDoomConfigSources(GUIDANCE_FILE, repositoryRoot, homeDirectory);
+		return mergeModelGuidance([DEFAULT_MODEL_GUIDANCE_PRESET, ...sources.map((source) => source.document)]);
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`[doompi-model-guidance] could not read ${GUIDANCE_FILE}: ${reason}\n`);
+		return DEFAULT_GUIDANCE;
+	}
+}
+//#endregion
+export { mergeModelGuidance as a, guidanceForModel as i, loadModelGuidance as n, DEFAULT_MODEL_GUIDANCE_PRESET as o, applyModelGuidance as r, GUIDANCE_FILE as t };
+
+//# sourceMappingURL=modelGuidanceStore-BPKgawjz.mjs.map

package/dist/modelGuidanceStore-BPKgawjz.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelGuidanceStore-BPKgawjz.mjs","names":[],"sources":["../src/constants/modelGuidance.ts","../src/services/modelGuidance/index.ts","../src/services/modelGuidanceStore/index.ts"],"sourcesContent":["export const DEFAULT_GUIDANCE = {\n  'gpt-6-astra':\n    'Continue executing an agreed plan and its scoped tasks without pausing for small decisions or repeated confirmation. Treat the accepted plan and task list as authorization to complete the work, make reasonable low-risk and reversible implementation choices, and verify the result. Ask only when blocked or when a decision would materially change scope, requirements, security, data safety, or destructive behavior.',\n} as const;\nexport const DEFAULT_MODEL_GUIDANCE_PRESET = { modelGuidance: DEFAULT_GUIDANCE } as const;\n","import { DEFAULT_GUIDANCE, DEFAULT_MODEL_GUIDANCE_PRESET } from '../../constants/modelGuidance';\nimport type { ModelGuidanceDocument, ModelGuidanceMap } from '../../types/modelGuidance';\nexport { DEFAULT_MODEL_GUIDANCE_PRESET } from '../../constants/modelGuidance';\nObject.freeze(DEFAULT_GUIDANCE);\nObject.freeze(DEFAULT_MODEL_GUIDANCE_PRESET);\n/**\n * Folds guidance documents in source order, so a later document overrides one\n * model id at a time.\n *\n * The reader hands back global then repository, so a repository entry wins the\n * ids it names while global entries it does not name survive. That per-id\n * granularity is the point: a personal default stays useful inside a project\n * that only pins one model.\n *\n * Non-string values are dropped rather than rejected, because a guidance file is\n * optional user input and one bad entry must not discard the rest.\n */\nexport function mergeModelGuidance(documents: readonly ModelGuidanceDocument[]): ModelGuidanceMap {\n  const merged: Record<string, string> = {};\n  for (const document of documents) {\n    for (const [modelId, guidance] of Object.entries(document.modelGuidance ?? {})) {\n      if (typeof guidance !== 'string') continue;\n      const trimmed = guidance.trim();\n      if (trimmed) merged[modelId] = trimmed;\n    }\n  }\n  return merged;\n}\n\n/** Exact-match lookup. An unknown or absent model id contributes nothing. */\nexport function guidanceForModel(guidance: ModelGuidanceMap, modelId: string | undefined): string | undefined {\n  if (!modelId) return undefined;\n  return guidance[modelId];\n}\n\n/**\n * Builds the replacement system prompt for one turn.\n *\n * Pi treats a returned `systemPrompt` as a full replacement and chains handlers,\n * so the incoming prompt has to be re-embedded. Returning bare guidance would\n * discard every earlier contribution, including plan mode and the persona.\n * Keeping that in one function leaves a single place for it to be right.\n */\nexport function applyModelGuidance(systemPrompt: string, guidance: string | undefined): string | undefined {\n  if (!guidance) return undefined;\n  return `${systemPrompt}\\n\\n${guidance}`;\n}\n","import { readDoomConfigSources } from '@agimon-ai/doompi-config/layeredConfig';\n\nimport { DEFAULT_GUIDANCE } from '../../constants/modelGuidance';\nimport type { ModelGuidanceDocument, ModelGuidanceMap } from '../../types/modelGuidance';\nimport { DEFAULT_MODEL_GUIDANCE_PRESET, mergeModelGuidance } from '../modelGuidance';\n\n/** Layered guidance document, read from the global then the repository `.doom` directory. */\nexport const GUIDANCE_FILE = 'model-guidance.yaml';\n\n/**\n * Reads and folds the global and repository guidance documents.\n *\n * Fails open. The reader parses YAML without a guard, so a typo in an optional\n * prompt file would otherwise throw on every turn of the session. Degrading to\n * the built-in preset keeps the package useful without letting malformed user\n * input end the turn.\n *\n * `homeDirectory` exists so a test can point the global scope at a temporary\n * directory; production callers omit it and the reader falls back to the real home.\n */\nexport function loadModelGuidance(repositoryRoot: string | undefined, homeDirectory?: string): ModelGuidanceMap {\n  if (!repositoryRoot) return DEFAULT_GUIDANCE;\n\n  try {\n    const sources = readDoomConfigSources<ModelGuidanceDocument>(GUIDANCE_FILE, repositoryRoot, homeDirectory);\n    return mergeModelGuidance([DEFAULT_MODEL_GUIDANCE_PRESET, ...sources.map((source) => source.document)]);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    process.stderr.write(`[doompi-model-guidance] could not read ${GUIDANCE_FILE}: ${reason}\\n`);\n    return DEFAULT_GUIDANCE;\n  }\n}\n"],"mappings":";;AAAA,MAAa,mBAAmB,EAC9B,eACE,iaACJ;AACA,MAAa,gCAAgC,EAAE,eAAe,iBAAiB;;;ACD/E,OAAO,OAAO,gBAAgB;AAC9B,OAAO,OAAO,6BAA6B;;;;;;;;;;;;;AAa3C,SAAgB,mBAAmB,WAA+D;CAChG,MAAM,SAAiC,CAAC;CACxC,KAAK,MAAM,YAAY,WACrB,KAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,SAAS,iBAAiB,CAAC,CAAC,GAAG;EAC9E,IAAI,OAAO,aAAa,UAAU;EAClC,MAAM,UAAU,SAAS,KAAK;EAC9B,IAAI,SAAS,OAAO,WAAW;CACjC;CAEF,OAAO;AACT;;AAGA,SAAgB,iBAAiB,UAA4B,SAAiD;CAC5G,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,OAAO,SAAS;AAClB;;;;;;;;;AAUA,SAAgB,mBAAmB,cAAsB,UAAkD;CACzG,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,OAAO,GAAG,aAAa,MAAM;AAC/B;;;;ACvCA,MAAa,gBAAgB;;;;;;;;;;;;AAa7B,SAAgB,kBAAkB,gBAAoC,eAA0C;CAC9G,IAAI,CAAC,gBAAgB,OAAO;CAE5B,IAAI;EACF,MAAM,UAAU,sBAA6C,eAAe,gBAAgB,aAAa;EACzG,OAAO,mBAAmB,CAAC,+BAA+B,GAAG,QAAQ,KAAK,WAAW,OAAO,QAAQ,CAAC,CAAC;CACxG,SAAS,OAAO;EACd,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACpE,QAAQ,OAAO,MAAM,0CAA0C,cAAc,IAAI,OAAO,GAAG;EAC3F,OAAO;CACT;AACF"}

package/dist/modelGuidanceStore-DEs_jtoI.cjs

@@ -0,0 +1,111 @@
+let _agimon_ai_doompi_config_layeredConfig = require("@agimon-ai/doompi-config/layeredConfig");
+//#region src/constants/modelGuidance.ts
+const DEFAULT_GUIDANCE = { "gpt-6-astra": "Continue executing an agreed plan and its scoped tasks without pausing for small decisions or repeated confirmation. Treat the accepted plan and task list as authorization to complete the work, make reasonable low-risk and reversible implementation choices, and verify the result. Ask only when blocked or when a decision would materially change scope, requirements, security, data safety, or destructive behavior." };
+const DEFAULT_MODEL_GUIDANCE_PRESET = { modelGuidance: DEFAULT_GUIDANCE };
+//#endregion
+//#region src/services/modelGuidance/index.ts
+Object.freeze(DEFAULT_GUIDANCE);
+Object.freeze(DEFAULT_MODEL_GUIDANCE_PRESET);
+/**
+* Folds guidance documents in source order, so a later document overrides one
+* model id at a time.
+*
+* The reader hands back global then repository, so a repository entry wins the
+* ids it names while global entries it does not name survive. That per-id
+* granularity is the point: a personal default stays useful inside a project
+* that only pins one model.
+*
+* Non-string values are dropped rather than rejected, because a guidance file is
+* optional user input and one bad entry must not discard the rest.
+*/
+function mergeModelGuidance(documents) {
+	const merged = {};
+	for (const document of documents) for (const [modelId, guidance] of Object.entries(document.modelGuidance ?? {})) {
+		if (typeof guidance !== "string") continue;
+		const trimmed = guidance.trim();
+		if (trimmed) merged[modelId] = trimmed;
+	}
+	return merged;
+}
+/** Exact-match lookup. An unknown or absent model id contributes nothing. */
+function guidanceForModel(guidance, modelId) {
+	if (!modelId) return void 0;
+	return guidance[modelId];
+}
+/**
+* Builds the replacement system prompt for one turn.
+*
+* Pi treats a returned `systemPrompt` as a full replacement and chains handlers,
+* so the incoming prompt has to be re-embedded. Returning bare guidance would
+* discard every earlier contribution, including plan mode and the persona.
+* Keeping that in one function leaves a single place for it to be right.
+*/
+function applyModelGuidance(systemPrompt, guidance) {
+	if (!guidance) return void 0;
+	return `${systemPrompt}\n\n${guidance}`;
+}
+//#endregion
+//#region src/services/modelGuidanceStore/index.ts
+/** Layered guidance document, read from the global then the repository `.doom` directory. */
+const GUIDANCE_FILE = "model-guidance.yaml";
+/**
+* Reads and folds the global and repository guidance documents.
+*
+* Fails open. The reader parses YAML without a guard, so a typo in an optional
+* prompt file would otherwise throw on every turn of the session. Degrading to
+* the built-in preset keeps the package useful without letting malformed user
+* input end the turn.
+*
+* `homeDirectory` exists so a test can point the global scope at a temporary
+* directory; production callers omit it and the reader falls back to the real home.
+*/
+function loadModelGuidance(repositoryRoot, homeDirectory) {
+	if (!repositoryRoot) return DEFAULT_GUIDANCE;
+	try {
+		const sources = (0, _agimon_ai_doompi_config_layeredConfig.readDoomConfigSources)(GUIDANCE_FILE, repositoryRoot, homeDirectory);
+		return mergeModelGuidance([DEFAULT_MODEL_GUIDANCE_PRESET, ...sources.map((source) => source.document)]);
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		process.stderr.write(`[doompi-model-guidance] could not read ${GUIDANCE_FILE}: ${reason}\n`);
+		return DEFAULT_GUIDANCE;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "DEFAULT_MODEL_GUIDANCE_PRESET", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_MODEL_GUIDANCE_PRESET;
+	}
+});
+Object.defineProperty(exports, "GUIDANCE_FILE", {
+	enumerable: true,
+	get: function() {
+		return GUIDANCE_FILE;
+	}
+});
+Object.defineProperty(exports, "applyModelGuidance", {
+	enumerable: true,
+	get: function() {
+		return applyModelGuidance;
+	}
+});
+Object.defineProperty(exports, "guidanceForModel", {
+	enumerable: true,
+	get: function() {
+		return guidanceForModel;
+	}
+});
+Object.defineProperty(exports, "loadModelGuidance", {
+	enumerable: true,
+	get: function() {
+		return loadModelGuidance;
+	}
+});
+Object.defineProperty(exports, "mergeModelGuidance", {
+	enumerable: true,
+	get: function() {
+		return mergeModelGuidance;
+	}
+});
+
+//# sourceMappingURL=modelGuidanceStore-DEs_jtoI.cjs.map

package/dist/modelGuidanceStore-DEs_jtoI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelGuidanceStore-DEs_jtoI.cjs","names":["readDoomConfigSources"],"sources":["../src/constants/modelGuidance.ts","../src/services/modelGuidance/index.ts","../src/services/modelGuidanceStore/index.ts"],"sourcesContent":["export const DEFAULT_GUIDANCE = {\n  'gpt-6-astra':\n    'Continue executing an agreed plan and its scoped tasks without pausing for small decisions or repeated confirmation. Treat the accepted plan and task list as authorization to complete the work, make reasonable low-risk and reversible implementation choices, and verify the result. Ask only when blocked or when a decision would materially change scope, requirements, security, data safety, or destructive behavior.',\n} as const;\nexport const DEFAULT_MODEL_GUIDANCE_PRESET = { modelGuidance: DEFAULT_GUIDANCE } as const;\n","import { DEFAULT_GUIDANCE, DEFAULT_MODEL_GUIDANCE_PRESET } from '../../constants/modelGuidance';\nimport type { ModelGuidanceDocument, ModelGuidanceMap } from '../../types/modelGuidance';\nexport { DEFAULT_MODEL_GUIDANCE_PRESET } from '../../constants/modelGuidance';\nObject.freeze(DEFAULT_GUIDANCE);\nObject.freeze(DEFAULT_MODEL_GUIDANCE_PRESET);\n/**\n * Folds guidance documents in source order, so a later document overrides one\n * model id at a time.\n *\n * The reader hands back global then repository, so a repository entry wins the\n * ids it names while global entries it does not name survive. That per-id\n * granularity is the point: a personal default stays useful inside a project\n * that only pins one model.\n *\n * Non-string values are dropped rather than rejected, because a guidance file is\n * optional user input and one bad entry must not discard the rest.\n */\nexport function mergeModelGuidance(documents: readonly ModelGuidanceDocument[]): ModelGuidanceMap {\n  const merged: Record<string, string> = {};\n  for (const document of documents) {\n    for (const [modelId, guidance] of Object.entries(document.modelGuidance ?? {})) {\n      if (typeof guidance !== 'string') continue;\n      const trimmed = guidance.trim();\n      if (trimmed) merged[modelId] = trimmed;\n    }\n  }\n  return merged;\n}\n\n/** Exact-match lookup. An unknown or absent model id contributes nothing. */\nexport function guidanceForModel(guidance: ModelGuidanceMap, modelId: string | undefined): string | undefined {\n  if (!modelId) return undefined;\n  return guidance[modelId];\n}\n\n/**\n * Builds the replacement system prompt for one turn.\n *\n * Pi treats a returned `systemPrompt` as a full replacement and chains handlers,\n * so the incoming prompt has to be re-embedded. Returning bare guidance would\n * discard every earlier contribution, including plan mode and the persona.\n * Keeping that in one function leaves a single place for it to be right.\n */\nexport function applyModelGuidance(systemPrompt: string, guidance: string | undefined): string | undefined {\n  if (!guidance) return undefined;\n  return `${systemPrompt}\\n\\n${guidance}`;\n}\n","import { readDoomConfigSources } from '@agimon-ai/doompi-config/layeredConfig';\n\nimport { DEFAULT_GUIDANCE } from '../../constants/modelGuidance';\nimport type { ModelGuidanceDocument, ModelGuidanceMap } from '../../types/modelGuidance';\nimport { DEFAULT_MODEL_GUIDANCE_PRESET, mergeModelGuidance } from '../modelGuidance';\n\n/** Layered guidance document, read from the global then the repository `.doom` directory. */\nexport const GUIDANCE_FILE = 'model-guidance.yaml';\n\n/**\n * Reads and folds the global and repository guidance documents.\n *\n * Fails open. The reader parses YAML without a guard, so a typo in an optional\n * prompt file would otherwise throw on every turn of the session. Degrading to\n * the built-in preset keeps the package useful without letting malformed user\n * input end the turn.\n *\n * `homeDirectory` exists so a test can point the global scope at a temporary\n * directory; production callers omit it and the reader falls back to the real home.\n */\nexport function loadModelGuidance(repositoryRoot: string | undefined, homeDirectory?: string): ModelGuidanceMap {\n  if (!repositoryRoot) return DEFAULT_GUIDANCE;\n\n  try {\n    const sources = readDoomConfigSources<ModelGuidanceDocument>(GUIDANCE_FILE, repositoryRoot, homeDirectory);\n    return mergeModelGuidance([DEFAULT_MODEL_GUIDANCE_PRESET, ...sources.map((source) => source.document)]);\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n    process.stderr.write(`[doompi-model-guidance] could not read ${GUIDANCE_FILE}: ${reason}\\n`);\n    return DEFAULT_GUIDANCE;\n  }\n}\n"],"mappings":";;AAAA,MAAa,mBAAmB,EAC9B,eACE,iaACJ;AACA,MAAa,gCAAgC,EAAE,eAAe,iBAAiB;;;ACD/E,OAAO,OAAO,gBAAgB;AAC9B,OAAO,OAAO,6BAA6B;;;;;;;;;;;;;AAa3C,SAAgB,mBAAmB,WAA+D;CAChG,MAAM,SAAiC,CAAC;CACxC,KAAK,MAAM,YAAY,WACrB,KAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,SAAS,iBAAiB,CAAC,CAAC,GAAG;EAC9E,IAAI,OAAO,aAAa,UAAU;EAClC,MAAM,UAAU,SAAS,KAAK;EAC9B,IAAI,SAAS,OAAO,WAAW;CACjC;CAEF,OAAO;AACT;;AAGA,SAAgB,iBAAiB,UAA4B,SAAiD;CAC5G,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,OAAO,SAAS;AAClB;;;;;;;;;AAUA,SAAgB,mBAAmB,cAAsB,UAAkD;CACzG,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,OAAO,GAAG,aAAa,MAAM;AAC/B;;;;ACvCA,MAAa,gBAAgB;;;;;;;;;;;;AAa7B,SAAgB,kBAAkB,gBAAoC,eAA0C;CAC9G,IAAI,CAAC,gBAAgB,OAAO;CAE5B,IAAI;EACF,MAAM,WAAA,GAAUA,uCAAAA,sBAAAA,CAA6C,eAAe,gBAAgB,aAAa;EACzG,OAAO,mBAAmB,CAAC,+BAA+B,GAAG,QAAQ,KAAK,WAAW,OAAO,QAAQ,CAAC,CAAC;CACxG,SAAS,OAAO;EACd,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;EACpE,QAAQ,OAAO,MAAM,0CAA0C,cAAc,IAAI,OAAO,GAAG;EAC3F,OAAO;CACT;AACF"}

package/llms.txt

@@ -0,0 +1,11 @@
+# @agimon-ai/doompi-model-guidance
+
+Package-owned guidance for per-model system prompt guidance, layered across global and repository scope
+
+## How to use
+
+- [Use Model Guidance](./src/prompts/doompi-use-model-guidance/SKILL.md): Configure per-model system prompt text and understand how the two scopes merge.
+
+## Resources
+
+- [Package README](./README.md): Installation, development commands, Pi entrypoint, and extension-specific usage.

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "@agimon-ai/doompi-model-guidance",
+  "version": "0.0.1-alpha.101",
+  "description": "Per-model system prompt guidance for Pi agents, layered across global and repository scope.",
+  "keywords": [
+    "ai",
+    "coding-agent",
+    "developer-tools",
+    "doompi",
+    "model-guidance",
+    "pi-coding-agent",
+    "pi-extension",
+    "pi-package",
+    "system-prompt",
+    "typescript"
+  ],
+  "homepage": "https://agimon.ai",
+  "bugs": {
+    "url": "https://github.com/AgiFlow/doompi/issues"
+  },
+  "license": "MIT",
+  "author": "Vuong Ngo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgiFlow/doompi.git",
+    "directory": "layers/llm/doompi-model-guidance"
+  },
+  "files": [
+    "dist",
+    "src/prompts",
+    "llms.txt",
+    "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/pi": {
+      "types": "./dist/extensions/pi.d.mts",
+      "import": "./dist/extensions/pi.mjs",
+      "require": "./dist/extensions/pi.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/doompi-config": "0.0.1-alpha.101",
+    "@agimon-ai/doompi-core": "0.0.1-alpha.102",
+    "@deepseek-ai/cordis": "4.0.2"
+  },
+  "devDependencies": {
+    "@agimon-ai/doompi-build": "0.0.1-alpha.24",
+    "@earendil-works/pi-coding-agent": "0.99.1",
+    "@types/node": "26.6.2",
+    "@vitest/coverage-v8": "5.0.1",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "0.99.1"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "doompiMcp": {
+    "entry": "./generated/mcp.ts",
+    "dist": "./dist/extensions/mcp.mjs",
+    "scopes": [
+      "session"
+    ]
+  },
+  "doompiServer": {
+    "entry": "./generated/server.ts",
+    "dist": "./dist/extensions/server.mjs",
+    "scopes": [
+      "session"
+    ],
+    "contracts": {
+      "entry": "./src/exports/apiContracts.ts",
+      "dist": "./dist/apiContracts.mjs"
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./dist/extensions/pi.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/doompi-use-model-guidance/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: doompi-use-model-guidance
+description: 'Use @agimon-ai/doompi-model-guidance: per-model system prompt guidance, layered across global and repository scope'
+---
+
+# Use Model Guidance
+
+Read the package [README](../../../README.md) for its exact installation, configuration, and behavior.
+
+## Guidance
+
+Importing the package as a bare entry in `modes.yaml` activates its built-in
+`default` preset, including the package guidance for `gpt-6-astra`.
+
+Override or add guidance for a model id in either scope:
+
+- Global, applying to every repository: `~/.pi/.doom/model-guidance.yaml`
+- Repository, applying to one project: `<repository>/.doom/model-guidance.yaml`
+
+```yaml
+modelGuidance:
+  claude-opus-5: |
+    Keep the task focused. Never go off rails.
+```
+
+Model ids match exactly. Use the id shown by `/model`, not a family or a
+marketing name. A model with no custom entry uses its built-in preset entry when
+one exists; otherwise it gets no guidance.
+
+The built-in preset applies first. Global guidance overrides it per model id,
+then repository guidance overrides global guidance per model id.
+
+Guidance is read per turn, so an edit takes effect on the next message with no
+restart.