@agimon-ai/po-help 0.0.0-alpha.3 → 0.0.0-alpha.5

package/README.md

@@ -12,7 +12,7 @@ Requires Node.js 24 or newer and the Pi version declared in this package's peer
 
 ## Activate and diagnose
 
-Use the minor-mode menu, `/minor help`, or `/doom-help`. Help is additive: unrelated tools, skills, and modes retain their existing activation and permission rules.
+Use the minor-mode menu, `/minor help`, or `/po-help`. Help is additive: unrelated tools, skills, and modes retain their existing activation and permission rules.
 
 The mode detail reports applied Help skill and diagnostic-tool counts. Pending discovery is not presented as a successful skill count. A failed contributor can leave Help degraded while healthy contributions remain usable.
 
@@ -41,7 +41,7 @@ Publish `llms.txt` and `src/prompts` in the package files allowlist. Relative li
 ### Tools
 
 ```ts
-import { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';
+import { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';
 ```
 
 Contributor packages import the shared contract from Core, not the optional Help package, so the distribution does not acquire an unconditional minor-mode dependency.

package/dist/extensions/server.cjs

@@ -8,7 +8,7 @@ let _agimon_ai_po_core_extensionFile = require("@agimon-ai/po-core/extensionFile
 let _agimon_ai_po_minor_mode = require("@agimon-ai/po-minor-mode");
 let typebox = require("typebox");
 //#region src/constants/help.ts
-const HELP_COMMAND_NAME = "doom-help";
+const HELP_COMMAND_NAME = "po-help";
 const HELP_COMMAND_DESCRIPTION = "Toggle Help guidance and read-only support diagnostics";
 const HELP_MODE_ID = "help";
 const HELP_PACKAGE_SOURCE = "@agimon-ai/po-help";
@@ -73,7 +73,7 @@ function createHelpStatusTool(inspect, authorize) {
 		name: HELP_STATUS_TOOL_NAME,
 		description: HELP_STATUS_TOOL_DESCRIPTION,
 		parameters: helpStatusParameters,
-		when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+		when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 		promptGuidelines: [HELP_GUIDANCE],
 		async execute(_input, execution) {
 			const signal = authorize(execution.signal);
@@ -119,13 +119,13 @@ function createHelpServerSession(host) {
 	};
 	const resources = [
 		{
-			when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 			name: "po-help",
 			kind: "context",
 			read: () => HELP_GUIDANCE
 		},
 		{
-			when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 			...HELP_SKILL,
 			kind: "skill",
 			path: (0, _agimon_ai_po_core_serverFacet.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-help/SKILL.md"),
@@ -136,7 +136,7 @@ function createHelpServerSession(host) {
 			}
 		},
 		{
-			when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 			...HELP_CHATGPT_SKILL,
 			kind: "skill",
 			path: (0, _agimon_ai_po_core_serverFacet.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-use-chatgpt-instructions/SKILL.md"),
@@ -147,7 +147,7 @@ function createHelpServerSession(host) {
 			}
 		},
 		{
-			when: _agimon_ai_po_core_help.DOOM_HELP_WHEN,
+			when: _agimon_ai_po_core_help.PO_HELP_WHEN,
 			...HELP_NATIVE_SKILL,
 			kind: "skill",
 			path: (0, _agimon_ai_po_core_serverFacet.packageResourcePath)(require("url").pathToFileURL(__filename).href, "src/prompts/po-develop-native-extension/SKILL.md"),
@@ -258,8 +258,8 @@ var root_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoot)((cont
 	};
 });
 //#endregion
-//#region src/extensions/workspaces/sessions/(backend)/command/doom-help.server.ts
-var doom_help_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.commands?.[0], { cardinality: "optional" });
+//#region src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts
+var po_help_server_default$1 = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts
 var po_develop_native_extension_server_default = (0, _agimon_ai_po_core_extensionFile.defineRoutedContribution)((context) => context.root.resources?.[3], { cardinality: "optional" });
@@ -296,7 +296,7 @@ const facet = (0, _agimon_ai_po_core_serverFacet.defineServerPlugin)({
 		return {
 			...(0, _agimon_ai_po_core_extensionFile.composeRootHooks)(scopeSession),
 			get commands() {
-				return defined([via({ name: "doom-help" }, at(doom_help_server_default, contextSession))]);
+				return defined([via({ name: "po-help" }, at(po_help_server_default$1, contextSession))]);
 			},
 			get resources() {
 				return defined([

package/dist/extensions/server.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.cjs","names":["Type","defineTool","HELP_WHEN","HELP_WHEN","packageResourcePath","readPackageResource","defineMinorMode","serverMinorModes","defineRoot","runtime","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootHooks","commandDoomHelp","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/doom-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'doom-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'po-use-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read po-use-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'po-use-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'po-develop-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { DoomHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverFacet';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: DoomHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { DoomHeadlessCommand, DoomHeadlessHostService, DoomHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type DoomServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: DoomHeadlessHostService): DoomServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: DoomHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md');\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: DoomHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { DoomServerPluginDefinition, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<DoomServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<DoomServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: DoomServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandDoomHelp from '../src/extensions/workspaces/sessions/(backend)/command/doom-help.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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-help',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'doom-help' }, at(commandDoomHelp, contextSession))]); },\n      get resources(): DoomServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): DoomServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}
+{"version":3,"file":"server.cjs","names":["Type","defineTool","HELP_WHEN","HELP_WHEN","packageResourcePath","readPackageResource","defineMinorMode","serverMinorModes","defineRoot","runtime","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineRoutedContribution","defineServerPlugin","composeServerProviderOverrides","rootSession","composeRootHooks","commandPoHelp","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'po-use-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read po-use-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'po-use-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'po-develop-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverFacet';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: PoHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type PoServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: PoHeadlessHostService): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md');\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<PoServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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-help',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): PoServerSessionPlugin['commands'] { return defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}

package/dist/extensions/server.d.mts

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

package/dist/extensions/server.mjs

@@ -1,10 +1,10 @@
-import { DOOM_HELP_WHEN } from "@agimon-ai/po-core/help";
+import { PO_HELP_WHEN } from "@agimon-ai/po-core/help";
 import { composeServerProviderOverrides, defineServerPlugin, defineTool, packageResourcePath, readPackageResource } from "@agimon-ai/po-core/serverFacet";
 import { composeRootHooks, defineRoot, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
 import { defineMinorMode, serverMinorModes } from "@agimon-ai/po-minor-mode";
 import { Type } from "typebox";
 //#region src/constants/help.ts
-const HELP_COMMAND_NAME = "doom-help";
+const HELP_COMMAND_NAME = "po-help";
 const HELP_COMMAND_DESCRIPTION = "Toggle Help guidance and read-only support diagnostics";
 const HELP_MODE_ID = "help";
 const HELP_PACKAGE_SOURCE = "@agimon-ai/po-help";
@@ -69,7 +69,7 @@ function createHelpStatusTool(inspect, authorize) {
 		name: HELP_STATUS_TOOL_NAME,
 		description: HELP_STATUS_TOOL_DESCRIPTION,
 		parameters: helpStatusParameters,
-		when: DOOM_HELP_WHEN,
+		when: PO_HELP_WHEN,
 		promptGuidelines: [HELP_GUIDANCE],
 		async execute(_input, execution) {
 			const signal = authorize(execution.signal);
@@ -115,13 +115,13 @@ function createHelpServerSession(host) {
 	};
 	const resources = [
 		{
-			when: DOOM_HELP_WHEN,
+			when: PO_HELP_WHEN,
 			name: "po-help",
 			kind: "context",
 			read: () => HELP_GUIDANCE
 		},
 		{
-			when: DOOM_HELP_WHEN,
+			when: PO_HELP_WHEN,
 			...HELP_SKILL,
 			kind: "skill",
 			path: packageResourcePath(import.meta.url, "src/prompts/po-use-help/SKILL.md"),
@@ -132,7 +132,7 @@ function createHelpServerSession(host) {
 			}
 		},
 		{
-			when: DOOM_HELP_WHEN,
+			when: PO_HELP_WHEN,
 			...HELP_CHATGPT_SKILL,
 			kind: "skill",
 			path: packageResourcePath(import.meta.url, "src/prompts/po-use-chatgpt-instructions/SKILL.md"),
@@ -143,7 +143,7 @@ function createHelpServerSession(host) {
 			}
 		},
 		{
-			when: DOOM_HELP_WHEN,
+			when: PO_HELP_WHEN,
 			...HELP_NATIVE_SKILL,
 			kind: "skill",
 			path: packageResourcePath(import.meta.url, "src/prompts/po-develop-native-extension/SKILL.md"),
@@ -254,8 +254,8 @@ var root_server_default = defineRoot((context) => {
 	};
 });
 //#endregion
-//#region src/extensions/workspaces/sessions/(backend)/command/doom-help.server.ts
-var doom_help_server_default = defineRoutedContribution((context) => context.root.commands?.[0], { cardinality: "optional" });
+//#region src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts
+var po_help_server_default$1 = defineRoutedContribution((context) => context.root.commands?.[0], { cardinality: "optional" });
 //#endregion
 //#region src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts
 var po_develop_native_extension_server_default = defineRoutedContribution((context) => context.root.resources?.[3], { cardinality: "optional" });
@@ -292,7 +292,7 @@ const facet = defineServerPlugin({
 		return {
 			...composeRootHooks(scopeSession),
 			get commands() {
-				return defined([via({ name: "doom-help" }, at(doom_help_server_default, contextSession))]);
+				return defined([via({ name: "po-help" }, at(po_help_server_default$1, contextSession))]);
 			},
 			get resources() {
 				return defined([

package/dist/extensions/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":["HELP_WHEN","HELP_WHEN","runtime","rootSession","commandDoomHelp","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/doom-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'doom-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'po-use-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read po-use-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'po-use-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'po-develop-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { DoomHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverFacet';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: DoomHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { DoomHeadlessCommand, DoomHeadlessHostService, DoomHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { DOOM_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type DoomServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: DoomHeadlessHostService): DoomServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: DoomHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md');\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: DoomHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { DoomServerPluginDefinition, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<DoomServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<DoomServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: DoomServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { DoomServerPluginContext, DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<DoomServerPluginContext, Partial<DoomServerSessionPlugin>>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type DoomServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandDoomHelp from '../src/extensions/workspaces/sessions/(backend)/command/doom-help.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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-help',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): DoomServerSessionPlugin['commands'] { return defined([via({ name: 'doom-help' }, at(commandDoomHelp, contextSession))]); },\n      get resources(): DoomServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): DoomServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): DoomServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}
+{"version":3,"file":"server.mjs","names":["HELP_WHEN","HELP_WHEN","runtime","rootSession","commandPoHelp","resourcePoDevelopNativeExtension","resourcePoHelp","resourcePoUseChatgptInstructions","resourcePoUseHelp","toolHelpStatus"],"sources":["../../src/constants/help.ts","../../src/schemas/diagnostics.ts","../../src/services/helpStatus/index.ts","../../src/services/helpServerSession/index.ts","../../src/extensions/workspaces/sessions/(backend)/_lib/runtime.server.ts","../../src/extensions/workspaces/sessions/(backend)/root.server.ts","../../src/extensions/workspaces/sessions/(backend)/command/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server.ts","../../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server.ts","../../src/extensions/workspaces/sessions/(backend)/tool/help_status.server.ts","../../generated/server.ts"],"sourcesContent":["export const HELP_COMMAND_NAME = 'po-help';\nexport const HELP_COMMAND_DESCRIPTION = 'Toggle Help guidance and read-only support diagnostics';\nexport const HELP_MODE_ID = 'help';\nexport const HELP_PACKAGE_SOURCE = '@agimon-ai/po-help';\nexport const HELP_SKILL = {\n  name: 'po-use-help',\n  description:\n    'Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.',\n} as const;\nexport const HELP_GUIDANCE =\n  'Help mode is active. Read po-use-help, inspect the available diagnostics, and use the narrowest package guidance for the task. Diagnose before proposing changes. Help does not grant additional permissions.';\nexport const HELP_STATUS_TOOL_NAME = 'help_status';\nexport const HELP_STATUS_TOOL_DESCRIPTION =\n  'Inspect active Help skills, diagnostic tools, contributor ownership, and unavailable contributions in this session. Read-only; does not change selection or permissions.';\nexport const HELP_STATUS_LIMIT = 128;\n\nexport const HELP_CHATGPT_SKILL = {\n  name: 'po-use-chatgpt-instructions',\n  description:\n    \"Print a paste-ready ChatGPT project instruction (at most 8,000 characters) that routes code-mode work through this session's MCP tools and condenses every AGENTS.md rule. Writes no files.\",\n} as const;\n\nexport const HELP_NATIVE_SKILL = {\n  name: 'po-develop-native-extension',\n  description:\n    \"Add or change a Po package's phone UI (.native files, native templates) so it mirrors the cockpit, passes the native build, and is approved and verified before it ships.\",\n} as const;\n","import { Type } from 'typebox';\n\nexport const helpStatusParameters = Type.Object({}, { additionalProperties: false });\n","import type { PoHeadlessCapabilitySnapshot } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { defineTool } from '@agimon-ai/po-core/serverFacet';\n\nimport {\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_STATUS_LIMIT,\n  HELP_STATUS_TOOL_DESCRIPTION,\n  HELP_STATUS_TOOL_NAME,\n} from '../../constants/help';\nimport { helpStatusParameters } from '../../schemas/diagnostics';\nimport type { HelpStatusReport } from './type';\n\nexport function serverHelpStatus(snapshot: PoHeadlessCapabilitySnapshot, enabled: boolean): HelpStatusReport {\n  const entries = snapshot.capabilities.filter((entry) => entry.when?.state?.['minor-mode'] === HELP_MODE_ID);\n  const skills = entries.filter((entry) => entry.kind === 'skill');\n  const tools = entries.filter((entry) => entry.kind === 'tool');\n  const diagnostics = entries\n    .filter((entry) => enabled && entry.reason && entry.reason !== 'inactive')\n    .map((entry) => ({ source: entry.source, code: `HELP_${entry.reason!.replaceAll('-', '_').toUpperCase()}` }));\n  const ready = snapshot.ready;\n  return {\n    activation: !enabled ? 'inactive' : !ready ? 'activating' : diagnostics.length ? 'degraded' : 'active',\n    ready,\n    revision: snapshot.revision,\n    counts: {\n      skills: ready ? skills.filter((entry) => entry.active && entry.discoverable).length : null,\n      tools: tools.filter((entry) => entry.active).length,\n    },\n    skills: skills.slice(0, HELP_STATUS_LIMIT).map(({ name, source, active, discoverable, reason }) => ({\n      name,\n      source,\n      active: active && discoverable,\n      ...(reason ? { reason } : {}),\n    })),\n    tools: tools\n      .slice(0, HELP_STATUS_LIMIT)\n      .map(({ name, source, active, reason }) => ({ name, source, active, ...(reason ? { reason } : {}) })),\n    diagnostics: diagnostics.slice(0, HELP_STATUS_LIMIT),\n    truncated:\n      skills.length > HELP_STATUS_LIMIT || tools.length > HELP_STATUS_LIMIT || diagnostics.length > HELP_STATUS_LIMIT,\n  };\n}\n\nexport function helpStatusDetail(report: HelpStatusReport): string {\n  return `${report.counts.skills ?? 'pending'} Help skills, ${report.counts.tools} diagnostic tools${report.diagnostics.length ? ' (diagnostics available)' : ''}`;\n}\n\nexport function createHelpStatusTool(\n  inspect: () => HelpStatusReport | Promise<HelpStatusReport>,\n  authorize: (signal?: AbortSignal) => AbortSignal,\n) {\n  return defineTool({\n    name: HELP_STATUS_TOOL_NAME,\n    description: HELP_STATUS_TOOL_DESCRIPTION,\n    parameters: helpStatusParameters,\n    when: HELP_WHEN,\n    promptGuidelines: [HELP_GUIDANCE],\n    async execute(_input, execution) {\n      const signal = authorize(execution.signal);\n      const report = await inspect();\n      signal.throwIfAborted();\n      authorize(execution.signal);\n      return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }], details: report };\n    },\n  });\n}\n","import type { PoHeadlessCommand, PoHeadlessHostService, PoHeadlessResource } from '@agimon-ai/po-core/headless';\nimport { PO_HELP_WHEN as HELP_WHEN } from '@agimon-ai/po-core/help';\nimport { type PoServerSessionPlugin, packageResourcePath, readPackageResource } from '@agimon-ai/po-core/serverFacet';\nimport { defineMinorMode, serverMinorModes, type MinorModeOwner, type MinorModeState } from '@agimon-ai/po-minor-mode';\n\nimport {\n  HELP_COMMAND_DESCRIPTION,\n  HELP_COMMAND_NAME,\n  HELP_GUIDANCE,\n  HELP_MODE_ID,\n  HELP_PACKAGE_SOURCE,\n  HELP_CHATGPT_SKILL,\n  HELP_NATIVE_SKILL,\n  HELP_SKILL,\n} from '../../constants/help';\nimport { createHelpStatusTool, helpStatusDetail, serverHelpStatus } from '../helpStatus';\nexport function createHelpServerSession(host: PoHeadlessHostService): PoServerSessionPlugin {\n  let modeOwner: MinorModeOwner | undefined;\n  let pending: boolean | undefined;\n  let failure: string | undefined;\n  let generation = 0;\n  let disposed = false;\n  const active = () => (host.context.selection.state?.['minor-mode'] ?? []).includes(HELP_MODE_ID);\n  const inspect = () => serverHelpStatus(host.inspectCapabilities(), active());\n  const modeState = (): MinorModeState => {\n    const report = inspect();\n    return {\n      activation: pending === true ? 'activating' : active() ? 'active' : 'inactive',\n      condition:\n        pending !== undefined || !report.ready\n          ? 'queued'\n          : failure\n            ? 'failed'\n            : report.activation === 'degraded'\n              ? 'degraded'\n              : 'ready',\n      ...(pending !== undefined\n        ? { detail: 'applying Help capabilities' }\n        : failure\n          ? { detail: failure }\n          : active()\n            ? { detail: helpStatusDetail(report) }\n            : {}),\n      actions: [\n        {\n          id: 'activate',\n          enabled: !active() && pending === undefined,\n          ...(!active() && pending === undefined ? {} : { disabledReason: 'Help is active or changing.' }),\n        },\n        {\n          id: 'deactivate',\n          enabled: active() || pending === true,\n          ...(active() || pending === true ? {} : { disabledReason: 'Help mode is not active.' }),\n        },\n      ],\n    };\n  };\n  const resources: PoHeadlessResource[] = [\n    { when: HELP_WHEN, name: 'po-help', kind: 'context', read: () => HELP_GUIDANCE },\n    {\n      when: HELP_WHEN,\n      ...HELP_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-help/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-help/SKILL.md');\n        if (!text.trim()) throw new Error('The installed Help skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_CHATGPT_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-use-chatgpt-instructions/SKILL.md');\n        if (!text.trim()) throw new Error('The installed ChatGPT instruction skill is missing or unreadable.');\n        return text;\n      },\n    },\n    {\n      when: HELP_WHEN,\n      ...HELP_NATIVE_SKILL,\n      kind: 'skill',\n      path: packageResourcePath(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md'),\n      read: async () => {\n        const text = await readPackageResource(import.meta.url, 'src/prompts/po-develop-native-extension/SKILL.md');\n        if (!text.trim()) throw new Error('The installed native extension skill is missing or unreadable.');\n        return text;\n      },\n    },\n  ];\n  const selectMode = async (enabled: boolean, signal?: AbortSignal): Promise<void> => {\n    if (disposed) throw new Error('Help runtime is disposed.');\n    signal?.throwIfAborted();\n    const operation = ++generation;\n    pending = enabled;\n    failure = undefined;\n    modeOwner?.publish();\n    try {\n      if (enabled) await resources[1]!.read(host.context);\n      signal?.throwIfAborted();\n      if (operation !== generation || disposed) throw new Error('Help activation was cancelled.');\n      const modes = (host.context.selection.state?.['minor-mode'] ?? []).filter((mode) => mode !== HELP_MODE_ID);\n      await host.changeSelection({\n        axis: 'state',\n        key: 'minor-mode',\n        values: enabled ? [...modes, HELP_MODE_ID] : modes,\n      });\n    } catch (error) {\n      if (operation === generation) failure = (error instanceof Error ? error.message : String(error)).slice(0, 160);\n      throw error;\n    } finally {\n      if (operation === generation) {\n        pending = undefined;\n        modeOwner?.publish();\n      }\n    }\n  };\n  const command: PoHeadlessCommand = {\n    name: HELP_COMMAND_NAME,\n    description: HELP_COMMAND_DESCRIPTION,\n    async execute(_args, execution) {\n      await selectMode(!(pending ?? active()));\n      await execution.client.notify({\n        title: 'Po Help',\n        body: active() ? 'Help mode activated.' : 'Help mode deactivated.',\n        level: 'info',\n      });\n    },\n  };\n  modeOwner = defineMinorMode({\n    descriptor: {\n      source: HELP_PACKAGE_SOURCE,\n      id: HELP_MODE_ID,\n      label: 'Help',\n      description: 'Package guidance and read-only diagnostics for agent setup and debugging.',\n      order: 50,\n      actions: [\n        {\n          id: 'activate',\n          label: 'Activate',\n          description: 'Expose Help guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n        {\n          id: 'deactivate',\n          label: 'Deactivate',\n          description: 'Withdraw Help-only guidance and diagnostic tools.',\n          contexts: ['headless'],\n          parameters: [],\n        },\n      ],\n    },\n    state: modeState,\n    async handleAction(_runtime, actionId, _argumentsValue, { signal }) {\n      if (actionId !== 'activate' && actionId !== 'deactivate')\n        throw new Error(`Unknown Help mode action: ${actionId}`);\n      await selectMode(actionId === 'activate', signal);\n      return { message: active() ? 'Help mode activated.' : 'Help mode deactivated.' };\n    },\n  }).createOwner(undefined);\n  return {\n    services: [serverMinorModes([modeOwner])],\n    resources,\n    commands: [command],\n    tools: [\n      createHelpStatusTool(inspect, (signal) => {\n        signal?.throwIfAborted();\n        host.assertActive(HELP_PACKAGE_SOURCE);\n        if (disposed || !active()) throw new Error('Help mode is not active.');\n        return signal ?? new AbortController().signal;\n      }),\n    ],\n    onDispose() {\n      disposed = true;\n      generation += 1;\n    },\n  };\n}\n","import type { PoServerPluginDefinition, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nimport { createHelpServerSession } from '../../../../../services/helpServerSession';\n\nexport default (({ agent }): Partial<PoServerSessionPlugin> =>\n  agent ? createHelpServerSession(agent) : {}) satisfies NonNullable<PoServerPluginDefinition['session']>;\n","import { defineRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext } from '@agimon-ai/po-core/serverFacet';\n\nimport runtime from './_lib/runtime.server';\n\nexport default defineRoot((context: PoServerPluginContext) => {\n  const value = runtime(context);\n  return {\n    value,\n    services: value.services,\n    activities: value.activities,\n    onStart: value.onStart,\n    onStop: value.onStop,\n    onDispose: value.onDispose,\n  };\n});\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.commands?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[3],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[0],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[2],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.resources?.[1],\n  { cardinality: 'optional' },\n);\n","import { defineRoutedContribution, type WithRoot } from '@agimon-ai/po-core/extensionFile';\nimport type { PoServerPluginContext, PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\n\nexport default defineRoutedContribution(\n  (context: WithRoot<PoServerPluginContext, Partial<PoServerSessionPlugin>>) => context.root.tools?.[0],\n  { cardinality: 'optional' },\n);\n","// Generated by @agimon-ai/po-build. Do not edit by hand.\nimport { defineServerPlugin, type PoServerSessionPlugin } from '@agimon-ai/po-core/serverFacet';\nimport { composeServerProviderOverrides } from '@agimon-ai/po-core/serverFacet';\nimport { composeRootHooks } from '@agimon-ai/po-core/extensionFile';\n\nimport rootSession from '../src/extensions/workspaces/sessions/(backend)/root.server';\nimport commandPoHelp from '../src/extensions/workspaces/sessions/(backend)/command/po-help.server';\nimport resourcePoDevelopNativeExtension from '../src/extensions/workspaces/sessions/(backend)/resource/po-develop-native-extension.server';\nimport resourcePoHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-help.server';\nimport resourcePoUseChatgptInstructions from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-chatgpt-instructions.server';\nimport resourcePoUseHelp from '../src/extensions/workspaces/sessions/(backend)/resource/po-use-help.server';\nimport toolHelpStatus from '../src/extensions/workspaces/sessions/(backend)/tool/help_status.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-help',\n  providerOverrides: composeServerProviderOverrides(rootSession),\n  session: async (context) => {\n    const scopeSession = await rootSession(context);\n    const contextSession = { ...context, root: scopeSession.value };\n    return {\n      ...composeRootHooks(scopeSession),\n      get commands(): PoServerSessionPlugin['commands'] { return defined([via({ name: 'po-help' }, at(commandPoHelp, contextSession))]); },\n      get resources(): PoServerSessionPlugin['resources'] { return defined([at(resourcePoDevelopNativeExtension, contextSession), at(resourcePoHelp, contextSession), at(resourcePoUseChatgptInstructions, contextSession), at(resourcePoUseHelp, contextSession)]); },\n      get tools(): PoServerSessionPlugin['tools'] { return defined([via({ name: 'help_status' }, at(toolHelpStatus, contextSession))]); },\n      services: [...(scopeSession.services ?? [])],\n      get activities(): PoServerSessionPlugin['activities'] { return [...(scopeSession.activities ?? [])]; },\n    };\n  },\n});\n\nexport default facet;\n"],"mappings":"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"}

package/dist/index.cjs

@@ -138,7 +138,7 @@ function diagnostic(source, code, error) {
 	return {
 		source,
 		code,
-		message: ((error instanceof Error ? error.message : String(error)) || "Unknown Help activation failure.").slice(0, _agimon_ai_po_core_help.DOOM_HELP_MAX_DIAGNOSTIC_LENGTH)
+		message: ((error instanceof Error ? error.message : String(error)) || "Unknown Help activation failure.").slice(0, _agimon_ai_po_core_help.PO_HELP_MAX_DIAGNOSTIC_LENGTH)
 	};
 }
 function contributionFingerprint(contributions) {
@@ -277,7 +277,7 @@ var DefaultHelpActivationService = class {
 			const skills = [];
 			const names = /* @__PURE__ */ new Set();
 			for (const source of loaded) for (const skill of source.skills) {
-				if (skills.length >= _agimon_ai_po_core_help.DOOM_HELP_MAX_SKILLS) {
+				if (skills.length >= _agimon_ai_po_core_help.PO_HELP_MAX_SKILLS) {
 					diagnostics.push(diagnostic(source.contribution.source, "HELP_SKILL_LIMIT", "The Help skill limit was reached."));
 					break;
 				}
@@ -288,7 +288,7 @@ var DefaultHelpActivationService = class {
 				names.add(skill.name);
 				skills.push({ ...skill });
 			}
-			const boundedDiagnostics = diagnostics.slice(0, _agimon_ai_po_core_help.DOOM_HELP_MAX_DIAGNOSTICS);
+			const boundedDiagnostics = diagnostics.slice(0, _agimon_ai_po_core_help.PO_HELP_MAX_DIAGNOSTICS);
 			if (skills.length === 0) {
 				this.publish({
 					activation: "inactive",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["DOOM_HELP_MAX_DIAGNOSTIC_LENGTH","DOOM_HELP_MAX_SKILLS","DOOM_HELP_MAX_DIAGNOSTICS","HELP_INDEX_PATH","isRecord","path","fs","fileURLToPath","os","poHomeDirectory","createHash","randomUUID","fs","createHash","path"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { DoomHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: DoomHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  DOOM_HELP_MAX_DIAGNOSTIC_LENGTH,\n  DOOM_HELP_MAX_DIAGNOSTICS,\n  DOOM_HELP_MAX_SKILLS,\n  type DoomHelpContribution,\n  type DoomHelpDiagnostic,\n  type DoomHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: DoomHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly DoomHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\n}\n\nfunction cloneContribution(contribution: DoomHelpContribution): DoomHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): DoomHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly DoomHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: DoomHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly DoomHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: DoomHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: DoomHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= DOOM_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, DOOM_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DoomHelpContribution, DoomHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: DoomHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly DoomHelpSkill[]> {\n    const skills: DoomHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DoomHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: DoomHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { DoomHelpContribution, DoomHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: DoomHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly DoomHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["PO_HELP_MAX_DIAGNOSTIC_LENGTH","PO_HELP_MAX_SKILLS","PO_HELP_MAX_DIAGNOSTICS","HELP_INDEX_PATH","isRecord","path","fs","fileURLToPath","os","poHomeDirectory","createHash","randomUUID","fs","createHash","path"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\n}\n\nfunction cloneContribution(contribution: PoHelpContribution): PoHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { DoomHelpActivation, DoomHelpContribution, DoomHelpDiagnostic, DoomHelpService, DoomHelpSkill } from "@agimon-ai/po-core/help";
+import { PoHelpActivation, PoHelpContribution, PoHelpDiagnostic, PoHelpService, PoHelpSkill } from "@agimon-ai/po-core/help";
 //#region src/types/help.d.ts
 interface HelpPackageIdentity {
   source: string;
@@ -16,15 +16,15 @@ interface ResolvedHelpIndex {
   digest: string;
 }
 interface HelpIndexResolver {
-  resolve(contribution: DoomHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex>;
+  resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex>;
 }
 interface HelpSkillMaterializer {
-  materialize(contribution: DoomHelpContribution, index: ResolvedHelpIndex, signal: AbortSignal): Promise<readonly DoomHelpSkill[]>;
+  materialize(contribution: PoHelpContribution, index: ResolvedHelpIndex, signal: AbortSignal): Promise<readonly PoHelpSkill[]>;
 }
 interface HelpRuntimeState {
-  activation: DoomHelpActivation;
-  skills: readonly DoomHelpSkill[];
-  diagnostics: readonly DoomHelpDiagnostic[];
+  activation: PoHelpActivation;
+  skills: readonly PoHelpSkill[];
+  diagnostics: readonly PoHelpDiagnostic[];
 }
 interface HelpSnapshotPublisher {
   publish(snapshot: HelpRuntimeState): unknown;
@@ -37,7 +37,7 @@ interface HelpActivationDependencies {
 }
 interface HelpActivationService {
   getState(): HelpRuntimeState;
-  replaceContributions(contributions: readonly DoomHelpContribution[]): void;
+  replaceContributions(contributions: readonly PoHelpContribution[]): void;
   subscribe(listener: (state: HelpRuntimeState) => void): () => void;
   activate(signal?: AbortSignal): Promise<HelpRuntimeState>;
   deactivate(): HelpRuntimeState;
@@ -70,7 +70,7 @@ export declare class DefaultHelpActivationService implements HelpActivationServi
   private disposed;
   constructor(dependencies: HelpActivationDependencies);
   getState(): HelpRuntimeState;
-  replaceContributions(contributions: readonly DoomHelpContribution[]): void;
+  replaceContributions(contributions: readonly PoHelpContribution[]): void;
   subscribe(listener: (state: HelpRuntimeState) => void): () => void;
   private publish;
   private loadSources;
@@ -90,7 +90,7 @@ interface HelpRuntimeComposition {
   activation: DefaultHelpActivationService;
   dispose(): void;
 }
-export declare function createHelpRuntime(service: DoomHelpService, options?: HelpRuntimeOptions): HelpRuntimeComposition;
+export declare function createHelpRuntime(service: PoHelpService, options?: HelpRuntimeOptions): HelpRuntimeComposition;
 //#endregion
 //#region src/services/helpStorage/index.d.ts
 interface CachedHelpIndex {
@@ -112,7 +112,7 @@ export declare class HelpIndexCache {
 export declare class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {
   private readonly cacheRoot;
   constructor(cacheRoot?: string);
-  materialize(contribution: DoomHelpContribution, index: ResolvedHelpIndex, signal: AbortSignal): Promise<readonly DoomHelpSkill[]>;
+  materialize(contribution: PoHelpContribution, index: ResolvedHelpIndex, signal: AbortSignal): Promise<readonly PoHelpSkill[]>;
 }
 //#endregion
 //#region src/services/llmsResolver/index.d.ts
@@ -126,7 +126,7 @@ export declare class DefaultHelpIndexResolver implements HelpIndexResolver {
   private readonly fetcher;
   private readonly timeoutMs;
   constructor(options?: DefaultHelpIndexResolverOptions);
-  resolve(contribution: DoomHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex>;
+  resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex>;
 }
 //#endregion
 export type { HelpActivationDependencies, HelpActivationService, HelpFetch, HelpFetchResponse, HelpIndexLocation, HelpIndexResolver, HelpPackageIdentity, HelpRuntimeComposition, HelpRuntimeOptions, HelpRuntimeState, HelpSkillMaterializer, HelpSnapshotPublisher, ResolvedHelpIndex };

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/help.ts","../src/services/helpActivation/index.ts","../src/services/helpRuntime/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts"],"mappings":";;UAOiB;EACf;EACA;EACA;EACA;;KAGU;UAEK;EACf,UAAU;EACV,UAAU;EACV;EACA;EACA;EACA;;UAGe;EACf,QAAQ,cAAc,sBAAsB,QAAQ,cAAc,QAAQ;;UAG3D;EACf,YACE,cAAc,sBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;UAGL;EACf,YAAY;EACZ,iBAAiB;EACjB,sBAAsB;;UAGP;EACf,QAAQ,UAAU;;UAGH;EACf,UAAU;EACV,cAAc;EACd,WAAW;EACX,kBAAkB;;UAGH;EACf,YAAY;EACZ,qBAAqB,wBAAwB;EAC7C,UAAU,WAAW,OAAO;EAC5B,SAAS,SAAS,cAAc,QAAQ;EACxC,cAAc;EACd;;UAGe;EACf;EACA;EACA;IAAW,IAAI;;EACf,QAAQ;EACR,eAAe,QAAQ;;KAGb,aACV,eACA;EAAQ,QAAQ;EAAa;MAC1B,QAAQ;;;qBCFA,wCAAwC;mBAClC;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,cAAc;EAI1B,YAAY;EAIZ,qBAAqB,wBAAwB;EAgC7C,UAAU,WAAW,OAAO;UAKpB;UAQM;EA2BR,SAAS,iBAAiB,cAAc,QAAQ;EAiFtD,cAAc;EAOd;;;;UCpPe;EACf;EACA,QAAQ;EACR;EACA,mBAAmB;;UAGJ;EACf,YAAY;EACZ;;wBASc,kBAAkB,SAAS,iBAAiB,UAAS,qBAA0B;;;UCU9E;EACf,OAAO;EACP;EACA;EACA;EACA;;wBAuEc,qBAAqB;qBAiCxB;WACF;EAET,YAAY;EAIZ,eAAe,UAAU;EAKzB,QAAQ,UAAU;EAIlB,KAAK,UAAU,sBAAsB;EAwBrC,QACE,UAAU,qBACV,OAAO,YACP,mBACA,uBACA,QAAQ,cACP;;qBA8CQ,wCAAwC;mBACtB;EAA7B,YAA6B;EAEvB,YACJ,cAAc,sBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;;;UC5NL;EACf,QAAQ;EACR,QAAQ;EACR;;qBAoGW,oCAAoC;mBAC9B;mBACA;mBACA;EAEjB,YAAY,UAAS;EAMf,QAAQ,cAAc,sBAAsB,QAAQ,cAAc,QAAQ"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/help.ts","../src/services/helpActivation/index.ts","../src/services/helpRuntime/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts"],"mappings":";;UAEiB;EACf;EACA;EACA;EACA;;KAGU;UAEK;EACf,UAAU;EACV,UAAU;EACV;EACA;EACA;EACA;;UAGe;EACf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ;;UAGzD;EACf,YACE,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;UAGL;EACf,YAAY;EACZ,iBAAiB;EACjB,sBAAsB;;UAGP;EACf,QAAQ,UAAU;;UAGH;EACf,UAAU;EACV,cAAc;EACd,WAAW;EACX,kBAAkB;;UAGH;EACf,YAAY;EACZ,qBAAqB,wBAAwB;EAC7C,UAAU,WAAW,OAAO;EAC5B,SAAS,SAAS,cAAc,QAAQ;EACxC,cAAc;EACd;;UAGe;EACf;EACA;EACA;IAAW,IAAI;;EACf,QAAQ;EACR,eAAe,QAAQ;;KAGb,aACV,eACA;EAAQ,QAAQ;EAAa;MAC1B,QAAQ;;;qBCGA,wCAAwC;mBAClC;mBACA;UACT;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,cAAc;EAI1B,YAAY;EAIZ,qBAAqB,wBAAwB;EAgC7C,UAAU,WAAW,OAAO;UAKpB;UAQM;EA2BR,SAAS,iBAAiB,cAAc,QAAQ;EAiFtD,cAAc;EAOd;;;;UCpPe;EACf;EACA,QAAQ;EACR;EACA,mBAAmB;;UAGJ;EACf,YAAY;EACZ;;wBASc,kBAAkB,SAAS,eAAe,UAAS,qBAA0B;;;UCU5E;EACf,OAAO;EACP;EACA;EACA;EACA;;wBAuEc,qBAAqB;qBAiCxB;WACF;EAET,YAAY;EAIZ,eAAe,UAAU;EAKzB,QAAQ,UAAU;EAIlB,KAAK,UAAU,sBAAsB;EAwBrC,QACE,UAAU,qBACV,OAAO,YACP,mBACA,uBACA,QAAQ,cACP;;qBA8CQ,wCAAwC;mBACtB;EAA7B,YAA6B;EAEvB,YACJ,cAAc,oBACd,OAAO,mBACP,QAAQ,cACP,iBAAiB;;;;UC5NL;EACf,QAAQ;EACR,QAAQ;EACR;;qBAoGW,oCAAoC;mBAC9B;mBACA;mBACA;EAEjB,YAAY,UAAS;EAMf,QAAQ,cAAc,oBAAoB,QAAQ,cAAc,QAAQ"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { DOOM_HELP_MAX_DIAGNOSTICS, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH, DOOM_HELP_MAX_SKILLS } from "@agimon-ai/po-core/help";
+import { PO_HELP_MAX_DIAGNOSTICS, PO_HELP_MAX_DIAGNOSTIC_LENGTH, PO_HELP_MAX_SKILLS } from "@agimon-ai/po-core/help";
 import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";
@@ -112,7 +112,7 @@ function diagnostic(source, code, error) {
 	return {
 		source,
 		code,
-		message: ((error instanceof Error ? error.message : String(error)) || "Unknown Help activation failure.").slice(0, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH)
+		message: ((error instanceof Error ? error.message : String(error)) || "Unknown Help activation failure.").slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH)
 	};
 }
 function contributionFingerprint(contributions) {
@@ -251,7 +251,7 @@ var DefaultHelpActivationService = class {
 			const skills = [];
 			const names = /* @__PURE__ */ new Set();
 			for (const source of loaded) for (const skill of source.skills) {
-				if (skills.length >= DOOM_HELP_MAX_SKILLS) {
+				if (skills.length >= PO_HELP_MAX_SKILLS) {
 					diagnostics.push(diagnostic(source.contribution.source, "HELP_SKILL_LIMIT", "The Help skill limit was reached."));
 					break;
 				}
@@ -262,7 +262,7 @@ var DefaultHelpActivationService = class {
 				names.add(skill.name);
 				skills.push({ ...skill });
 			}
-			const boundedDiagnostics = diagnostics.slice(0, DOOM_HELP_MAX_DIAGNOSTICS);
+			const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);
 			if (skills.length === 0) {
 				this.publish({
 					activation: "inactive",

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["HELP_INDEX_PATH","isRecord"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { DoomHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: DoomHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  DOOM_HELP_MAX_DIAGNOSTIC_LENGTH,\n  DOOM_HELP_MAX_DIAGNOSTICS,\n  DOOM_HELP_MAX_SKILLS,\n  type DoomHelpContribution,\n  type DoomHelpDiagnostic,\n  type DoomHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: DoomHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly DoomHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\n}\n\nfunction cloneContribution(contribution: DoomHelpContribution): DoomHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): DoomHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, DOOM_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly DoomHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: DoomHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly DoomHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: DoomHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: DoomHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= DOOM_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, DOOM_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DoomHelpContribution, DoomHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: DoomHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly DoomHelpSkill[]> {\n    const skills: DoomHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DoomHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: DoomHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { DoomHelpContribution, DoomHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: DoomHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly DoomHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["HELP_INDEX_PATH","isRecord"],"sources":["../src/services/llmsContent/index.ts","../src/services/helpActivation/index.ts","../src/services/helpStorage/index.ts","../src/services/llmsResolver/index.ts","../src/services/helpRuntime/index.ts"],"sourcesContent":["import type { PoHelpSkillDescriptor } from '@agimon-ai/po-core/help';\n\nimport type { ResolvedHelpIndex } from '../../types/help';\n\nexport const MAX_LLMS_BYTES = 1024 * 1024;\nexport const MAX_AGGREGATE_LLMS_BYTES = 4 * MAX_LLMS_BYTES;\n\nconst MARKDOWN_LINK_PATTERN = /!?\\[[^\\]]*\\]\\(\\s*<?([^\\s)>]+)>?(?:\\s+[^)]*)?\\)/gu;\nconst MARKDOWN_REFERENCE_LINK_PATTERN = /^\\s{0,3}\\[[^\\]\\r\\n]+\\]:\\s*<?([^\\s>]+)>?/gmu;\nconst MARKDOWN_AUTOLINK_PATTERN = /<((?:\\.{0,2}\\/|[A-Za-z][A-Za-z0-9+.-]*:)[^<>\\s]+)>/gu;\nconst HTML_LINK_PATTERN = /\\b(?:href|src)\\s*=\\s*[\"']([^\"']+)[\"']/giu;\nconst URI_SCHEME_PATTERN = /^[a-z][a-z0-9+.-]*:/iu;\nconst NESTED_PATH_ENCODING_PATTERN = /%(?:25|2e|2f|3a|5c)/iu;\nconst SAFE_EXTERNAL_SCHEMES = new Set(['http:', 'https:', 'mailto:']);\n\nfunction externalScheme(target: string): string | undefined {\n  if (!URI_SCHEME_PATTERN.test(target)) return undefined;\n  return target.slice(0, target.indexOf(':') + 1).toLowerCase();\n}\n\nfunction decodeRelativeTarget(rawTarget: string): string {\n  let decoded = rawTarget;\n  try {\n    for (let pass = 0; pass < 2; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    throw new Error(`llms.txt contains an invalid encoded link '${rawTarget}'.`);\n  }\n  if (NESTED_PATH_ENCODING_PATTERN.test(decoded)) {\n    throw new Error(`llms.txt contains an unsafe nested encoding in link '${rawTarget}'.`);\n  }\n  return decoded;\n}\n\nfunction validateRelativeLink(rawTarget: string): void {\n  if (!rawTarget || rawTarget.startsWith('#')) return;\n  const rawScheme = externalScheme(rawTarget);\n  if (rawScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(rawScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${rawScheme}'.`);\n    }\n    return;\n  }\n\n  const decoded = decodeRelativeTarget(rawTarget);\n  const decodedScheme = externalScheme(decoded);\n  if (decodedScheme) {\n    if (!SAFE_EXTERNAL_SCHEMES.has(decodedScheme)) {\n      throw new Error(`llms.txt contains unsupported link scheme '${decodedScheme}'.`);\n    }\n    return;\n  }\n  const withoutSuffix = decoded.split(/[?#]/u, 1)[0]?.replaceAll('\\\\', '/') ?? '';\n  if (withoutSuffix.startsWith('/') || withoutSuffix.split('/').some((segment) => segment === '..')) {\n    throw new Error(`llms.txt link '${rawTarget}' escapes the package root.`);\n  }\n}\n\nfunction containsUnsafeControl(text: string): boolean {\n  for (const character of text) {\n    const code = character.codePointAt(0) ?? 0;\n    if ((code >= 0 && code <= 8) || code === 11 || code === 12 || (code >= 14 && code <= 31) || code === 127) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function validateLlmsBytes(bytes: Uint8Array): string {\n  if (bytes.byteLength === 0) throw new Error('llms.txt is empty.');\n  if (bytes.byteLength > MAX_LLMS_BYTES) throw new Error(`llms.txt exceeds ${MAX_LLMS_BYTES} bytes.`);\n\n  let text: string;\n  try {\n    text = new TextDecoder('utf-8', { fatal: true }).decode(bytes);\n  } catch {\n    throw new Error('llms.txt is not valid UTF-8.');\n  }\n  if (text.startsWith('\\uFEFF')) text = text.slice(1);\n  if (containsUnsafeControl(text)) throw new Error('llms.txt contains unsafe control bytes.');\n\n  const firstContentLine = text\n    .split(/\\r?\\n/u)\n    .find((line) => line.trim().length > 0)\n    ?.trim();\n  if (!firstContentLine || !/^#\\s+\\S/u.test(firstContentLine)) {\n    throw new Error('llms.txt must begin with a Markdown H1 heading.');\n  }\n  for (const pattern of [\n    MARKDOWN_LINK_PATTERN,\n    MARKDOWN_REFERENCE_LINK_PATTERN,\n    MARKDOWN_AUTOLINK_PATTERN,\n    HTML_LINK_PATTERN,\n  ]) {\n    for (const match of text.matchAll(pattern)) validateRelativeLink(match[1] ?? '');\n  }\n  return text;\n}\n\nexport function renderHelpSkillWrapper(descriptor: PoHelpSkillDescriptor, index: ResolvedHelpIndex): string {\n  const name = JSON.stringify(descriptor.name);\n  const description = JSON.stringify(descriptor.description);\n  const indexPath = JSON.stringify(index.filePath);\n  const referenceBase = JSON.stringify(index.referenceBase);\n  return `---\\nname: ${name}\\ndescription: ${description}\\n---\\n\\n# Package Help\\n\\nRead the validated package Help index at ${indexPath}.\\nResolve relative links in that index against ${referenceBase}.\\nOpen only the linked documents relevant to the current request, as needed; do not recursively load the whole reference set.\\n`;\n}\n","import {\n  PO_HELP_MAX_DIAGNOSTIC_LENGTH,\n  PO_HELP_MAX_DIAGNOSTICS,\n  PO_HELP_MAX_SKILLS,\n  type PoHelpContribution,\n  type PoHelpDiagnostic,\n  type PoHelpSkill,\n} from '@agimon-ai/po-core/help';\n\nimport type {\n  HelpActivationDependencies,\n  HelpActivationService,\n  HelpRuntimeState,\n  ResolvedHelpIndex,\n} from '../../types/help';\nimport { MAX_AGGREGATE_LLMS_BYTES } from '../llmsContent';\n\nconst MAX_RESOLUTION_CONCURRENCY = 4;\nconst FAILURE_MESSAGE = 'No package Help source could be activated.';\nconst CANCELLATION_MESSAGE = 'Help activation was cancelled.';\n\ninterface LoadedSource {\n  contribution: PoHelpContribution;\n  index: ResolvedHelpIndex;\n  skills: readonly PoHelpSkill[];\n}\n\ninterface SourceOutcome {\n  source: string;\n  loaded?: LoadedSource;\n  error?: unknown;\n}\n\nexport class HelpActivationError extends Error {\n  constructor(message = FAILURE_MESSAGE) {\n    super(message);\n    this.name = 'HelpActivationError';\n  }\n}\n\nfunction cloneContribution(contribution: PoHelpContribution): PoHelpContribution {\n  return {\n    source: contribution.source,\n    moduleUrl: contribution.moduleUrl,\n    skills: contribution.skills.map((skill) => ({ ...skill })),\n  };\n}\n\nfunction cloneState(state: HelpRuntimeState): HelpRuntimeState {\n  return {\n    activation: state.activation,\n    skills: state.skills.map((skill) => ({ ...skill })),\n    diagnostics: state.diagnostics.map((diagnostic) => ({ ...diagnostic })),\n  };\n}\n\nfunction diagnostic(source: string, code: string, error: unknown): PoHelpDiagnostic {\n  const raw = error instanceof Error ? error.message : String(error);\n  const message = (raw || 'Unknown Help activation failure.').slice(0, PO_HELP_MAX_DIAGNOSTIC_LENGTH);\n  return { source, code, message };\n}\n\nfunction contributionFingerprint(contributions: readonly PoHelpContribution[]): string {\n  return JSON.stringify(\n    contributions.map((contribution) => ({\n      source: contribution.source,\n      moduleUrl: contribution.moduleUrl,\n      skills: contribution.skills,\n    })),\n  );\n}\n\nexport class DefaultHelpActivationService implements HelpActivationService {\n  private readonly dependencies: HelpActivationDependencies;\n  private readonly listeners = new Set<(state: HelpRuntimeState) => void>();\n  private contributions: PoHelpContribution[] = [];\n  private fingerprint = '[]';\n  private state: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private settledState: HelpRuntimeState = { activation: 'inactive', skills: [], diagnostics: [] };\n  private generation = 0;\n  private controller: AbortController | undefined;\n  private disposed = false;\n\n  constructor(dependencies: HelpActivationDependencies) {\n    this.dependencies = dependencies;\n  }\n\n  getState(): HelpRuntimeState {\n    return cloneState(this.state);\n  }\n\n  replaceContributions(contributions: readonly PoHelpContribution[]): void {\n    if (this.disposed) return;\n    const next = contributions.map(cloneContribution).sort((left, right) => left.source.localeCompare(right.source));\n    const fingerprint = contributionFingerprint(next);\n    if (fingerprint === this.fingerprint) return;\n    const previous = new Map(this.contributions.map((entry) => [entry.source, contributionFingerprint([entry])]));\n    const retained = new Set(\n      next\n        .filter((entry) => previous.get(entry.source) === contributionFingerprint([entry]))\n        .map((entry) => entry.source),\n    );\n    // A refresh may retain unchanged owners, never withdrawn or replaced ones.\n    // Prune the rollback snapshot too, so cancellation cannot resurrect them.\n    const skills = this.settledState.skills.filter((entry) => retained.has(entry.source));\n    const diagnostics = this.settledState.diagnostics.filter((entry) => !entry.source || retained.has(entry.source));\n    this.settledState = {\n      activation: skills.length === 0 ? 'inactive' : diagnostics.length > 0 ? 'degraded' : 'active',\n      skills,\n      diagnostics,\n    };\n    this.contributions = next;\n    this.fingerprint = fingerprint;\n    if (this.state.activation !== 'inactive') {\n      void this.activate().catch((error: unknown) => {\n        // Activation failures publish a bounded settled state before rejecting.\n        // Only unexpected implementation failures need an out-of-band report.\n        if (error instanceof HelpActivationError) return;\n        this.dependencies.onBackgroundError(error);\n      });\n    }\n  }\n\n  subscribe(listener: (state: HelpRuntimeState) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  private publish(state: HelpRuntimeState): HelpRuntimeState {\n    this.state = cloneState(state);\n    if (state.activation !== 'activating') this.settledState = cloneState(state);\n    this.dependencies.publisher.publish(this.state);\n    for (const listener of this.listeners) listener(cloneState(this.state));\n    return this.getState();\n  }\n\n  private async loadSources(signal: AbortSignal): Promise<SourceOutcome[]> {\n    const contributions = this.contributions;\n    const outcomes: SourceOutcome[] = Array.from({ length: contributions.length });\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (cursor < contributions.length) {\n        const index = cursor;\n        cursor += 1;\n        const contribution = contributions[index];\n        if (!contribution) return;\n        if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n        try {\n          const resolved = await this.dependencies.resolver.resolve(contribution, signal);\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          const skills = await this.dependencies.materializer.materialize(contribution, resolved, signal);\n          outcomes[index] = { source: contribution.source, loaded: { contribution, index: resolved, skills } };\n        } catch (error) {\n          if (signal.aborted) throw new HelpActivationError(CANCELLATION_MESSAGE);\n          outcomes[index] = { source: contribution.source, error };\n        }\n      }\n    };\n    const count = Math.min(MAX_RESOLUTION_CONCURRENCY, contributions.length);\n    await Promise.all(Array.from({ length: count }, () => worker()));\n    return outcomes;\n  }\n\n  async activate(externalSignal?: AbortSignal): Promise<HelpRuntimeState> {\n    if (this.disposed) throw new HelpActivationError('Help runtime is disposed.');\n    this.controller?.abort('Help activation generation replaced.');\n    const controller = new AbortController();\n    this.controller = controller;\n    const generation = ++this.generation;\n    const abortFromExternal = () => controller.abort(externalSignal?.reason);\n    externalSignal?.addEventListener('abort', abortFromExternal, { once: true });\n    if (externalSignal?.aborted) abortFromExternal();\n\n    const settledState = cloneState(this.settledState);\n    this.publish({ activation: 'activating', skills: settledState.skills, diagnostics: settledState.diagnostics });\n    try {\n      const outcomes = await this.loadSources(controller.signal);\n      if (controller.signal.aborted || generation !== this.generation) {\n        throw new HelpActivationError(CANCELLATION_MESSAGE);\n      }\n\n      const diagnostics: PoHelpDiagnostic[] = [];\n      const loaded: LoadedSource[] = [];\n      let aggregateBytes = 0;\n      for (const outcome of outcomes) {\n        if (!outcome) continue;\n        if (outcome.error || !outcome.loaded) {\n          diagnostics.push(diagnostic(outcome.source, 'HELP_SOURCE_FAILED', outcome.error));\n          continue;\n        }\n        if (aggregateBytes + outcome.loaded.index.byteLength > MAX_AGGREGATE_LLMS_BYTES) {\n          diagnostics.push(\n            diagnostic(outcome.source, 'HELP_AGGREGATE_LIMIT', 'The aggregate llms.txt byte limit was exceeded.'),\n          );\n          continue;\n        }\n        aggregateBytes += outcome.loaded.index.byteLength;\n        loaded.push(outcome.loaded);\n      }\n\n      const skills: PoHelpSkill[] = [];\n      const names = new Set<string>();\n      for (const source of loaded) {\n        for (const skill of source.skills) {\n          if (skills.length >= PO_HELP_MAX_SKILLS) {\n            diagnostics.push(\n              diagnostic(source.contribution.source, 'HELP_SKILL_LIMIT', 'The Help skill limit was reached.'),\n            );\n            break;\n          }\n          if (names.has(skill.name)) {\n            diagnostics.push(\n              diagnostic(\n                source.contribution.source,\n                'HELP_SKILL_COLLISION',\n                `Help skill '${skill.name}' was already provided by an earlier package source.`,\n              ),\n            );\n            continue;\n          }\n          names.add(skill.name);\n          skills.push({ ...skill });\n        }\n      }\n\n      const boundedDiagnostics = diagnostics.slice(0, PO_HELP_MAX_DIAGNOSTICS);\n      if (skills.length === 0) {\n        this.publish({ activation: 'inactive', skills: [], diagnostics: boundedDiagnostics });\n        throw new HelpActivationError();\n      }\n      return this.publish({\n        activation: boundedDiagnostics.length > 0 ? 'degraded' : 'active',\n        skills,\n        diagnostics: boundedDiagnostics,\n      });\n    } catch (error) {\n      if (generation === this.generation && this.state.activation === 'activating') this.publish(settledState);\n      throw error;\n    } finally {\n      externalSignal?.removeEventListener('abort', abortFromExternal);\n      if (this.controller === controller) this.controller = undefined;\n    }\n  }\n\n  deactivate(): HelpRuntimeState {\n    this.generation += 1;\n    this.controller?.abort('Help deactivated.');\n    this.controller = undefined;\n    return this.publish({ activation: 'inactive', skills: [], diagnostics: [] });\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.deactivate();\n    this.disposed = true;\n    this.listeners.clear();\n  }\n}\n","import { createHash, randomUUID } from 'node:crypto';\nimport fs from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { PoHelpContribution, PoHelpSkill } from '@agimon-ai/po-core/help';\nimport { poHomeDirectory } from '@agimon-ai/po-core/piSettings';\n\nimport type { HelpPackageIdentity, HelpSkillMaterializer, ResolvedHelpIndex } from '../../types/help';\nimport { renderHelpSkillWrapper } from '../llmsContent';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst HELP_INDEX_PATH = 'llms.txt';\nconst CACHE_SCHEMA_VERSION = 1;\nconst PRIVATE_FILE_MODE = 0o600;\nconst PRIVATE_DIRECTORY_MODE = 0o700;\nconst COMPLETION_FILE = '.complete';\nconst CACHE_METADATA_FILE = 'metadata.json';\nconst WRAPPER_DIRECTORY = 'wrappers';\nconst SKILL_FILE = 'SKILL.md';\nconst EXACT_SEMVER_PATTERN =\n  /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/u;\nconst NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\\/)?[a-z0-9][a-z0-9._~-]*$/u;\n\ninterface CacheMetadata {\n  schemaVersion: typeof CACHE_SCHEMA_VERSION;\n  source: string;\n  version: string;\n  path: typeof HELP_INDEX_PATH;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nexport interface CachedHelpIndex {\n  bytes: Uint8Array;\n  filePath: string;\n  integrity: string;\n  digest: string;\n  referenceBase: string;\n}\n\nfunction assertNotAborted(signal: AbortSignal): void {\n  if (signal.aborted) throw new Error('Help activation was cancelled.');\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isContained(root: string, candidate: string): boolean {\n  const relative = path.relative(root, candidate);\n  return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));\n}\n\nfunction readManifest(filePath: string): Record<string, unknown> {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8')) as unknown;\n  } catch (error) {\n    throw new Error(\n      `Cannot read Help package manifest at ${filePath}: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!isRecord(parsed)) throw new Error(`Help package manifest at ${filePath} must contain an object.`);\n  return parsed;\n}\n\nexport function resolveHelpPackageIdentity(moduleUrl: string, expectedSource: string): HelpPackageIdentity {\n  if (!NPM_PACKAGE_NAME_PATTERN.test(expectedSource)) {\n    throw new Error(`Help source '${expectedSource}' must be a valid lowercase npm package name.`);\n  }\n  let modulePath: string;\n  try {\n    const url = new URL(moduleUrl);\n    if (url.protocol !== 'file:') throw new Error(`Help module URL must use file:, received ${url.protocol}`);\n    modulePath = fs.realpathSync(fileURLToPath(url));\n  } catch (error) {\n    throw new Error(\n      `Invalid Help contributor module URL '${moduleUrl}': ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n  if (!fs.lstatSync(modulePath).isFile())\n    throw new Error(`Help contributor module is not a regular file: ${modulePath}`);\n\n  let directory = path.dirname(modulePath);\n  while (true) {\n    const manifestPath = path.join(directory, PACKAGE_MANIFEST);\n    if (fs.existsSync(manifestPath)) {\n      const manifest = readManifest(manifestPath);\n      const source = manifest.name;\n      const version = manifest.version;\n      if (source !== expectedSource) {\n        throw new Error(`Help source '${expectedSource}' does not match nearest package '${String(source)}'.`);\n      }\n      if (typeof version !== 'string' || !EXACT_SEMVER_PATTERN.test(version)) {\n        throw new Error(`Help package '${expectedSource}' must declare an exact semantic version.`);\n      }\n      const packageRoot = fs.realpathSync(directory);\n      if (!isContained(packageRoot, modulePath))\n        throw new Error('Help contributor module escapes its resolved package root.');\n      return { source: expectedSource, version, packageRoot, modulePath };\n    }\n    const parent = path.dirname(directory);\n    if (parent === directory) break;\n    directory = parent;\n  }\n  throw new Error(`Cannot find a package manifest for Help contributor ${modulePath}.`);\n}\n\nexport function defaultHelpCacheRoot(homeDirectory = os.homedir()): string {\n  return path.join(poHomeDirectory(homeDirectory), 'llms-cache');\n}\n\nexport function sha256Hex(bytes: Uint8Array | string): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nfunction parseCacheMetadata(value: unknown, identity: HelpPackageIdentity): CacheMetadata | undefined {\n  if (!isRecord(value)) return undefined;\n  if (\n    value.schemaVersion !== CACHE_SCHEMA_VERSION ||\n    value.source !== identity.source ||\n    value.version !== identity.version ||\n    value.path !== HELP_INDEX_PATH ||\n    typeof value.integrity !== 'string' ||\n    typeof value.digest !== 'string' ||\n    typeof value.referenceBase !== 'string'\n  ) {\n    return undefined;\n  }\n  return value as unknown as CacheMetadata;\n}\n\nfunction regularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nexport class HelpIndexCache {\n  readonly root: string;\n\n  constructor(root = defaultHelpCacheRoot()) {\n    this.root = root;\n  }\n\n  entryDirectory(identity: HelpPackageIdentity): string {\n    const key = sha256Hex(`${identity.source}\\0${identity.version}\\0${HELP_INDEX_PATH}`);\n    return path.join(this.root, key);\n  }\n\n  discard(identity: HelpPackageIdentity): void {\n    fs.rmSync(this.entryDirectory(identity), { recursive: true, force: true });\n  }\n\n  read(identity: HelpPackageIdentity): CachedHelpIndex | undefined {\n    const directory = this.entryDirectory(identity);\n    const completionPath = path.join(directory, COMPLETION_FILE);\n    const indexPath = path.join(directory, HELP_INDEX_PATH);\n    const metadataPath = path.join(directory, CACHE_METADATA_FILE);\n    if (!regularFile(completionPath) || !regularFile(indexPath) || !regularFile(metadataPath)) return undefined;\n    try {\n      const metadata = parseCacheMetadata(JSON.parse(fs.readFileSync(metadataPath, 'utf8')) as unknown, identity);\n      if (!metadata) return undefined;\n      const bytes = fs.readFileSync(indexPath);\n      if (sha256Hex(bytes) !== metadata.digest) return undefined;\n      if (fs.readFileSync(completionPath, 'utf8').trim() !== metadata.digest) return undefined;\n      return {\n        bytes,\n        filePath: indexPath,\n        integrity: metadata.integrity,\n        digest: metadata.digest,\n        referenceBase: metadata.referenceBase,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  publish(\n    identity: HelpPackageIdentity,\n    bytes: Uint8Array,\n    integrity: string,\n    referenceBase: string,\n    signal: AbortSignal,\n  ): CachedHelpIndex {\n    assertNotAborted(signal);\n    const existing = this.read(identity);\n    if (existing) return existing;\n    const directory = this.entryDirectory(identity);\n    fs.mkdirSync(this.root, { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n    if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n    const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n    const digest = sha256Hex(bytes);\n    const metadata: CacheMetadata = {\n      schemaVersion: CACHE_SCHEMA_VERSION,\n      source: identity.source,\n      version: identity.version,\n      path: HELP_INDEX_PATH,\n      integrity,\n      digest,\n      referenceBase,\n    };\n    try {\n      fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n      fs.writeFileSync(path.join(temporary, HELP_INDEX_PATH), bytes, { mode: PRIVATE_FILE_MODE });\n      fs.writeFileSync(path.join(temporary, CACHE_METADATA_FILE), `${JSON.stringify(metadata, null, 2)}\\n`, {\n        mode: PRIVATE_FILE_MODE,\n      });\n      assertNotAborted(signal);\n      fs.writeFileSync(path.join(temporary, COMPLETION_FILE), `${digest}\\n`, { mode: PRIVATE_FILE_MODE });\n      try {\n        fs.renameSync(temporary, directory);\n      } catch (error) {\n        const winner = this.read(identity);\n        if (winner) return winner;\n        throw error;\n      }\n      return {\n        bytes: Uint8Array.from(bytes),\n        filePath: path.join(directory, HELP_INDEX_PATH),\n        integrity,\n        digest,\n        referenceBase,\n      };\n    } finally {\n      fs.rmSync(temporary, { recursive: true, force: true });\n    }\n  }\n}\n\nexport class DefaultHelpSkillMaterializer implements HelpSkillMaterializer {\n  constructor(private readonly cacheRoot = defaultHelpCacheRoot()) {}\n\n  async materialize(\n    contribution: PoHelpContribution,\n    index: ResolvedHelpIndex,\n    signal: AbortSignal,\n  ): Promise<readonly PoHelpSkill[]> {\n    const skills: PoHelpSkill[] = [];\n    for (const descriptor of contribution.skills) {\n      assertNotAborted(signal);\n      const key = sha256Hex(\n        `${index.identity.source}\\0${index.identity.version}\\0${descriptor.name}\\0${descriptor.description}\\0${index.digest}`,\n      );\n      const directory = path.join(this.cacheRoot, WRAPPER_DIRECTORY, key);\n      const filePath = path.join(directory, SKILL_FILE);\n      const content = renderHelpSkillWrapper(descriptor, index);\n      if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) {\n        fs.mkdirSync(path.dirname(directory), { mode: PRIVATE_DIRECTORY_MODE, recursive: true });\n        if (fs.existsSync(directory)) fs.rmSync(directory, { recursive: true, force: true });\n        const temporary = `${directory}.${process.pid}.${randomUUID()}.tmp`;\n        try {\n          fs.mkdirSync(temporary, { mode: PRIVATE_DIRECTORY_MODE });\n          fs.writeFileSync(path.join(temporary, SKILL_FILE), content, { mode: PRIVATE_FILE_MODE });\n          assertNotAborted(signal);\n          try {\n            fs.renameSync(temporary, directory);\n          } catch (error) {\n            if (!regularFile(filePath) || fs.readFileSync(filePath, 'utf8') !== content) throw error;\n          }\n        } finally {\n          fs.rmSync(temporary, { recursive: true, force: true });\n        }\n      }\n      skills.push({\n        source: contribution.source,\n        name: descriptor.name,\n        description: descriptor.description,\n        filePath,\n        baseDir: directory,\n      });\n    }\n    return skills;\n  }\n}\n","import { createHash } from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { PoHelpContribution } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch, HelpFetchResponse, HelpIndexResolver, ResolvedHelpIndex } from '../../types/help';\nimport { HelpIndexCache, resolveHelpPackageIdentity, sha256Hex } from '../helpStorage';\nimport { MAX_LLMS_BYTES, validateLlmsBytes } from '../llmsContent';\n\nconst HELP_INDEX_PATH = 'llms.txt';\nconst UNPKG_ORIGIN = 'https://unpkg.com';\nconst DEFAULT_FETCH_TIMEOUT_MS = 5_000;\nconst MAX_METADATA_BYTES = 512 * 1024;\nconst MAX_REDIRECTS = 3;\nconst SRI_PATTERN = /^sha256-([A-Za-z0-9+/]+={0,2})$/u;\n\ninterface UnpkgMetadataFile {\n  path: string;\n  size?: number;\n  integrity: string;\n}\n\nexport interface DefaultHelpIndexResolverOptions {\n  cache?: HelpIndexCache;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n}\n\nfunction defaultFetch(input: string, init: { signal: AbortSignal; redirect: 'manual' }): Promise<HelpFetchResponse> {\n  return fetch(input, init) as unknown as Promise<HelpFetchResponse>;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isRegularFile(filePath: string): boolean {\n  try {\n    const metadata = fs.lstatSync(filePath);\n    return metadata.isFile() && !metadata.isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction unpkgPackagePath(source: string, version: string): string {\n  const encoded = source\n    .split('/')\n    .map((segment) =>\n      segment.startsWith('@') ? `@${encodeURIComponent(segment.slice(1))}` : encodeURIComponent(segment),\n    )\n    .join('/');\n  return `${encoded}@${encodeURIComponent(version)}`;\n}\n\nfunction exactUnpkgBase(source: string, version: string): string {\n  return `${UNPKG_ORIGIN}/${unpkgPackagePath(source, version)}/`;\n}\n\nfunction contentLength(response: HelpFetchResponse): number | undefined {\n  const raw = response.headers.get('content-length');\n  if (!raw) return undefined;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) && parsed >= 0 ? parsed : undefined;\n}\n\nfunction timeoutSignal(parent: AbortSignal, timeoutMs: number): { signal: AbortSignal; dispose(): void } {\n  const controller = new AbortController();\n  const abort = () => controller.abort(parent.reason);\n  parent.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(() => controller.abort(new Error('Help download timed out.')), timeoutMs);\n  if (parent.aborted) abort();\n  return {\n    signal: controller.signal,\n    dispose() {\n      clearTimeout(timer);\n      parent.removeEventListener('abort', abort);\n    },\n  };\n}\n\nasync function fetchExact(fetcher: HelpFetch, initialUrl: string, signal: AbortSignal): Promise<HelpFetchResponse> {\n  let url = initialUrl;\n  const expected = new URL(initialUrl);\n  for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {\n    const response = await fetcher(url, { signal, redirect: 'manual' });\n    if (response.status < 300 || response.status >= 400) return response;\n    const location = response.headers.get('location');\n    if (!location) throw new Error(`Unpkg redirected ${url} without a location.`);\n    const next = new URL(location, url);\n    if (next.origin !== UNPKG_ORIGIN || next.pathname !== expected.pathname || next.search !== expected.search) {\n      throw new Error(`Unpkg redirect escaped the exact package/version path: ${next.href}`);\n    }\n    url = next.href;\n  }\n  throw new Error(`Unpkg exceeded ${MAX_REDIRECTS} redirects.`);\n}\n\nfunction parseMetadata(text: string): UnpkgMetadataFile {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(text) as unknown;\n  } catch {\n    throw new Error('Unpkg metadata is not valid JSON.');\n  }\n  if (!isRecord(parsed) || !Array.isArray(parsed.files)) throw new Error('Unpkg metadata has no files list.');\n  const match = parsed.files.find((entry) => isRecord(entry) && entry.path === `/${HELP_INDEX_PATH}`);\n  if (!isRecord(match) || typeof match.integrity !== 'string') {\n    throw new Error(`Unpkg package does not publish /${HELP_INDEX_PATH}.`);\n  }\n  const size = typeof match.size === 'number' ? match.size : undefined;\n  if (size !== undefined && (!Number.isSafeInteger(size) || size < 0 || size > MAX_LLMS_BYTES)) {\n    throw new Error(`Unpkg /${HELP_INDEX_PATH} exceeds the Help size limit.`);\n  }\n  if (!SRI_PATTERN.test(match.integrity)) throw new Error('Unpkg llms.txt metadata does not contain SHA-256 SRI.');\n  return { path: match.path as string, ...(size === undefined ? {} : { size }), integrity: match.integrity };\n}\n\nfunction verifySri(bytes: Uint8Array, integrity: string): void {\n  const expected = SRI_PATTERN.exec(integrity)?.[1];\n  if (!expected) throw new Error('Invalid llms.txt SRI metadata.');\n  const actual = createHash('sha256').update(bytes).digest('base64');\n  if (actual !== expected) throw new Error('Downloaded llms.txt failed SRI verification.');\n}\n\nexport class DefaultHelpIndexResolver implements HelpIndexResolver {\n  private readonly cache: HelpIndexCache;\n  private readonly fetcher: HelpFetch;\n  private readonly timeoutMs: number;\n\n  constructor(options: DefaultHelpIndexResolverOptions = {}) {\n    this.cache = options.cache ?? new HelpIndexCache();\n    this.fetcher = options.fetch ?? defaultFetch;\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;\n  }\n\n  async resolve(contribution: PoHelpContribution, signal: AbortSignal): Promise<ResolvedHelpIndex> {\n    if (signal.aborted) throw new Error('Help activation was cancelled.');\n    const identity = resolveHelpPackageIdentity(contribution.moduleUrl, contribution.source);\n    const localPath = path.join(identity.packageRoot, HELP_INDEX_PATH);\n    if (fs.existsSync(localPath)) {\n      if (!isRegularFile(localPath)) throw new Error(`Bundled ${HELP_INDEX_PATH} must be a regular file.`);\n      const bytes = fs.readFileSync(localPath);\n      validateLlmsBytes(bytes);\n      return {\n        identity,\n        location: 'local',\n        filePath: localPath,\n        referenceBase: identity.packageRoot,\n        byteLength: bytes.byteLength,\n        digest: sha256Hex(bytes),\n      };\n    }\n\n    const cached = this.cache.read(identity);\n    if (cached) {\n      try {\n        validateLlmsBytes(cached.bytes);\n        return {\n          identity,\n          location: 'cache',\n          filePath: cached.filePath,\n          referenceBase: cached.referenceBase,\n          byteLength: cached.bytes.byteLength,\n          digest: cached.digest,\n        };\n      } catch {\n        this.cache.discard(identity);\n      }\n    }\n\n    const timed = timeoutSignal(signal, this.timeoutMs);\n    try {\n      const referenceBase = exactUnpkgBase(identity.source, identity.version);\n      const metadataResponse = await fetchExact(this.fetcher, `${referenceBase}?meta`, timed.signal);\n      const metadataLength = contentLength(metadataResponse);\n      if (metadataLength !== undefined && metadataLength > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      if (!metadataResponse.ok) throw new Error(`Unpkg metadata request failed with HTTP ${metadataResponse.status}.`);\n      const metadataText = await metadataResponse.text();\n      if (Buffer.byteLength(metadataText, 'utf8') > MAX_METADATA_BYTES) {\n        throw new Error('Unpkg metadata exceeds the Help metadata size limit.');\n      }\n      const metadata = parseMetadata(metadataText);\n      const indexResponse = await fetchExact(this.fetcher, `${referenceBase}${HELP_INDEX_PATH}`, timed.signal);\n      const indexLength = contentLength(indexResponse);\n      if (indexLength !== undefined && indexLength > MAX_LLMS_BYTES) {\n        throw new Error(`Downloaded ${HELP_INDEX_PATH} exceeds ${MAX_LLMS_BYTES} bytes.`);\n      }\n      if (!indexResponse.ok) throw new Error(`Unpkg llms.txt request failed with HTTP ${indexResponse.status}.`);\n      const bytes = new Uint8Array(await indexResponse.arrayBuffer());\n      validateLlmsBytes(bytes);\n      verifySri(bytes, metadata.integrity);\n      const published = this.cache.publish(identity, bytes, metadata.integrity, referenceBase, timed.signal);\n      return {\n        identity,\n        location: 'remote',\n        filePath: published.filePath,\n        referenceBase: published.referenceBase,\n        byteLength: published.bytes.byteLength,\n        digest: published.digest,\n      };\n    } finally {\n      timed.dispose();\n    }\n  }\n}\n","import type { PoHelpContribution, PoHelpService } from '@agimon-ai/po-core/help';\n\nimport type { HelpFetch } from '../../types/help';\nimport { DefaultHelpActivationService } from '../helpActivation';\nimport { DefaultHelpSkillMaterializer, defaultHelpCacheRoot, HelpIndexCache } from '../helpStorage';\nimport { DefaultHelpIndexResolver } from '../llmsResolver';\n\nexport interface HelpRuntimeOptions {\n  cacheRoot?: string;\n  fetch?: HelpFetch;\n  timeoutMs?: number;\n  onBackgroundError?(error: unknown): void;\n}\n\nexport interface HelpRuntimeComposition {\n  activation: DefaultHelpActivationService;\n  dispose(): void;\n}\n\nfunction reportAsync(error: unknown): void {\n  queueMicrotask(() => {\n    throw error instanceof Error ? error : new Error(String(error));\n  });\n}\n\nexport function createHelpRuntime(service: PoHelpService, options: HelpRuntimeOptions = {}): HelpRuntimeComposition {\n  const cacheRoot = options.cacheRoot ?? defaultHelpCacheRoot();\n  const cache = new HelpIndexCache(cacheRoot);\n  const activation = new DefaultHelpActivationService({\n    resolver: new DefaultHelpIndexResolver({ cache, fetch: options.fetch, timeoutMs: options.timeoutMs }),\n    materializer: new DefaultHelpSkillMaterializer(cacheRoot),\n    publisher: { publish: (snapshot) => service.publish(snapshot) },\n    onBackgroundError(error) {\n      if (options.onBackgroundError) options.onBackgroundError(error);\n      else reportAsync(error);\n    },\n  });\n  const synchronize = (contributions: readonly PoHelpContribution[]): void => {\n    activation.replaceContributions(contributions);\n  };\n  const unsubscribe = service.subscribeContributions((contributions) => synchronize(contributions));\n  synchronize(service.listContributions());\n  let disposed = false;\n  return {\n    activation,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      unsubscribe();\n      activation.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/llms.txt

@@ -1,6 +1,6 @@
-# Doom Pi Help
+# Po Pi Help
 
-Activation-gated, package-owned guidance for Doom Pi parent sessions.
+Activation-gated, package-owned guidance for Po Pi parent sessions.
 
 ## Resources
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-help",
-  "version": "0.0.0-alpha.3",
+  "version": "0.0.0-alpha.5",
   "description": "Activation-gated package guidance and help skills for Po and Pi extensions.",
   "keywords": [
     "agent-documentation",
@@ -58,24 +58,24 @@
     "access": "public"
   },
   "dependencies": {
-    "@agimon-ai/po-core": "0.0.0-alpha.3",
-    "@agimon-ai/po-minor-mode": "0.0.0-alpha.3",
-    "@agimon-ai/po-web-components": "0.0.0-alpha.3",
+    "@agimon-ai/po-core": "0.0.0-alpha.5",
+    "@agimon-ai/po-minor-mode": "0.0.0-alpha.5",
+    "@agimon-ai/po-web-components": "0.0.0-alpha.5",
     "@deepseek-ai/cordis": "4.0.4",
-    "typebox": "1.3.36"
+    "typebox": "1.3.37"
   },
   "devDependencies": {
-    "@agimon-ai/po-build": "0.0.0-alpha.3",
-    "@agimon-ai/vibe-lint-plugin-doom-extension": "0.0.0-alpha.3",
+    "@agimon-ai/po-build": "0.0.0-alpha.5",
+    "@agimon-ai/vibe-lint-plugin-po-extension": "0.0.0-alpha.5",
     "@earendil-works/pi-coding-agent": "1.2.0",
-    "@types/node": "25.9.9",
+    "@types/node": "26.6.5",
     "@types/react": "19.3.0",
-    "@vitest/coverage-v8": "5.0.3",
+    "@vitest/coverage-v8": "5.0.4",
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "tsdown": "0.23.1",
     "typescript": "7.0.2",
-    "vitest": "5.0.3"
+    "vitest": "5.0.4"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "1.2.0"

package/src/prompts/po-use-help/SKILL.md

@@ -3,13 +3,13 @@ name: po-use-help
 description: Set up and debug Po agents using installed package guidance and scoped, read-only diagnostics. Diagnose missing capabilities before proposing authorized repairs.
 ---
 
-# Use Doom Pi Help
+# Use Po Pi Help
 
 Use Help for agent setup, configuration, missing capabilities, and debugging the current session. Start from the user's expected behavior and an observed symptom. A skill describes a workflow; it does not grant the tools or permissions mentioned in it.
 
 ## Activate and inspect
 
-Toggle Help through the minor-mode menu, `SPC h e`, `/minor help`, or `/doom-help`. The command toggles on both Pi and the web/server host. Activation adds Help-only guidance and diagnostics without replacing the ordinary tool set or changing other modes.
+Toggle Help through the minor-mode menu, `SPC h e`, `/minor help`, or `/po-help`. The command toggles on both Pi and the web/server host. Activation adds Help-only guidance and diagnostics without replacing the ordinary tool set or changing other modes.
 
 Call `help_status` to inspect the applied Help capabilities and their owners. A pending skill count means discovery has not completed or its consumer is unavailable, not that every registered descriptor is usable. Report degraded contributors separately and continue with healthy contributions. Missing, shadowed, restricted, and unavailable resources are different conditions.