@agimon-ai/doompi-plan 0.0.1-alpha.28 → 0.0.1-alpha.29

package/README.md

@@ -1,10 +1,13 @@
 # @agimon-ai/doompi-plan
 
-A reviewable planning lifecycle for Pi with narrowed tools, plan storage, normal/debug/Fable flavors, and explicit completion.
+A reviewable planning lifecycle for Pi with narrowed tools, plan storage, normal, debug, and
+Fable-assisted flows, and explicit completion.
 
 Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Plan mode removes `edit` and `write` from the active tool set and directs writes through `write_plan`. It does not sandbox Bash, external tools, or the operating system, so treat it as tool-level workflow protection rather than a repository permission boundary.
+Plan mode removes `edit` and `write` from the active tool set and directs writes through
+`write_plan`. It does not sandbox Bash, external tools, or the operating system, so treat it as
+tool-level workflow protection rather than a repository permission boundary.
 
 > **Alpha:** planning flows and tool contracts may change between releases.
 
@@ -22,7 +25,7 @@ standalone Pi:
 pi install npm:@agimon-ai/doompi-plan
 ```
 
-DoomPi and plain Pi use the same `@agimon-ai/doompi-plan/extensions/pi` factory.
+DoomPi and standalone Pi use the same `@agimon-ai/doompi-plan/extensions/pi` extension.
 
 ## Start and exit
 
@@ -33,20 +36,33 @@ DoomPi and plain Pi use the same `@agimon-ai/doompi-plan/extensions/pi` factory.
 | `SPC p f` | Fable-assisted drafting followed by Pi verification        |
 | `SPC p e` | Exit and restore the prior model, thinking, and tool state |
 
-Normal planning expects repository exploration and delegation where available. Debug planning separates verified evidence from hypotheses. Fable is optional: Plan injects Team's `doom/fable-plan` service, treats returned text as untrusted, and requires Pi to verify and synthesize the final plan. Its child capability ceiling is contributed through `doom/subagent-policy` and retracts when either provider or Plan unloads.
+Normal planning expects repository exploration and delegation where available. Debug planning
+separates verified evidence from hypotheses. Fable is an optional Team-provided planning service.
+When Team provides `doom/fable-plan`, Plan treats returned text as untrusted and requires Pi to
+verify and synthesize the final plan. Its child capability ceiling comes from
+`doom/subagent-policy` and is removed when either provider or Plan unloads.
 
-A model or tool restoration failure leaves the narrowed Plan state active and reports the failure rather than pretending the session was restored.
+A model or tool restoration failure leaves the narrowed Plan state active and reports the failure
+rather than pretending the session was restored.
 
 ## Write and complete a plan
 
-`write_plan` accepts visible Markdown plan content and writes a unique file under `~/.pi/plans` by default. It refuses a hidden/empty plan and validates the destination before writing. The plan path and content become visible session state.
+`write_plan` accepts visible Markdown plan content and writes a unique file under `~/.pi/plans` by
+default. It refuses a plan that is empty or was not presented in visible assistant output, and it
+validates the destination before writing. The plan path and content become visible session state.
 
-After a plan exists, `complete_plan` asks whether to exit or continue planning. The user must explicitly approve exit. If the selected mode already exposes `ask_user_question`, Plan reuses it; it does not activate an omitted feedback layer.
+After a plan exists, `complete_plan` asks whether to exit or continue planning. The user must
+explicitly approve exit. If the selected mode already exposes `ask_user_question`, Plan reuses it;
+it does not activate an omitted feedback layer.
 
-In autonomous Voice mode, review choices are narrated, the turn terminates, and the next user message carries the decision.
+In autonomous Voice mode, review choices are narrated, the turn terminates, and the next user
+message carries the decision.
 
 ## Configure models and storage
 
+Put planning settings in the repository's `.doom/config.yaml` or the global
+`~/.pi/.doom/config.yaml`:
+
 ```yaml
 modes:
   planning:
@@ -59,11 +75,14 @@ modes:
     plansDirectory: ~/.pi/plans
 ```
 
-`main` controls the planning model, `subagents` controls delegated research defaults, and `plansDirectory` can be absolute, repository-relative, or under `~`. Planning and delegated model calls consume provider quota.
+`main` controls the planning model, `subagents` controls delegated research defaults, and
+`plansDirectory` can be absolute, repository-relative, or under `~`. Planning and delegated model
+calls consume provider quota.
 
 ## Public API
 
-The root exports planning configuration schemas, prompts, Fable flow helpers, and the Plan mode service. Focused exports include `/config`, `/planConfig`, `/planMode`, `/fableFlow`, and `/prompts`.
+The root exports planning configuration schemas, prompts, Fable flow helpers, and the Plan mode
+service. Focused exports include `/config`, `/planConfig`, `/planMode`, `/fableFlow`, and `/prompts`.
 
 ## Development
 

package/dist/adapters/pi/extension.cjs

@@ -1,2 +1,2 @@
-const e=require("../../services/planMode.cjs");let t=require("@agimon-ai/doompi-extension-contracts/cordis-host");function n(t,n){e.planModeExtension(t,n)}async function r(e){let n=await(0,t.connectDoomCordisHost)(e,`@agimon-ai/doompi-plan`),r=n.root.plugin(i,{pi:e});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let a;e.on(`session_shutdown`,()=>a??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}function i(e,t){n(e,t.pi)}exports.activatePlanExtension=r,exports.default=r,exports.installPlanRuntime=n;
+const e=require("../../services/planMode.cjs");let t=require("@agimon-ai/doompi-extension-contracts/cordis-host"),n=require("@agimon-ai/doompi-extension-contracts/help");const r=`@agimon-ai/doompi-plan`;function i(t,n){e.planModeExtension(t,n)}async function a(e){let n=await(0,t.connectDoomCordisHost)(e,r),i=n.root.plugin(o,{pi:e});try{await i}catch(e){try{await i.dispose()}finally{await n.dispose()}throw e}let a;e.on(`session_shutdown`,()=>a??=(async()=>{try{await i.dispose()}finally{await n.dispose()}})())}function o(e,t){e.inject([n.DOOM_HELP_SERVICE],e=>{let t=(0,n.requireDoomHelpService)(e).register({source:r,moduleUrl:require("url").pathToFileURL(__filename).href,skills:[{name:`doompi-use-plan`,description:`Use Doom Pi Plan to draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.`}]});return()=>t.dispose()}),i(e,t.pi)}exports.activatePlanExtension=a,exports.default=a,exports.installPlanRuntime=i;
 //# sourceMappingURL=extension.cjs.map

package/dist/adapters/pi/extension.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.cjs","names":["connectDoomCordisHost"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { planModeExtension } from '../../services/planMode.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-plan';\n\n/** Install Plan state and external resources into its host-owned Cordis plugin fiber. */\nexport function installPlanRuntime(cordis: Context, pi: ExtensionAPI): void {\n  planModeExtension(cordis, pi);\n}\n\n/** The package's single standard Pi factory, including all optional typed Doom integrations. */\nexport async function activatePlanExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(planPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface PlanPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction planPlugin(cordis: Context, config: PlanPluginConfig): void {\n  installPlanRuntime(cordis, config.pi);\n}\n\nexport default activatePlanExtension;\n"],"mappings":"kHAQA,SAAgB,EAAmB,EAAiB,EAAwB,CAC1E,EAAA,kBAAkB,EAAQ,CAAE,CAC9B,CAGA,eAAsB,EAAsB,EAAiC,CAC3E,IAAM,EAAa,MAAA,EAAMA,EAAAA,sBAAAA,CAAsB,EAAI,wBAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,IAAG,CAAC,EACvD,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAMA,SAAS,EAAW,EAAiB,EAAgC,CACnE,EAAmB,EAAQ,EAAO,EAAE,CACtC"}
+{"version":3,"file":"extension.cjs","names":["connectDoomCordisHost","DOOM_HELP_SERVICE","requireDoomHelpService"],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { planModeExtension } from '../../services/planMode.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-plan';\n\n/** Install Plan state and external resources into its host-owned Cordis plugin fiber. */\nexport function installPlanRuntime(cordis: Context, pi: ExtensionAPI): void {\n  planModeExtension(cordis, pi);\n}\n\n/** The package's single standard Pi factory, including all optional typed Doom integrations. */\nexport async function activatePlanExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(planPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface PlanPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction planPlugin(cordis: Context, config: PlanPluginConfig): void {\n  cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n    const contribution = requireDoomHelpService(helpContext).register({\n      source: PACKAGE_SOURCE,\n      moduleUrl: import.meta.url,\n      skills: [\n        {\n          name: 'doompi-use-plan',\n          description:\n            'Use Doom Pi Plan to draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n  installPlanRuntime(cordis, config.pi);\n}\n\nexport default activatePlanExtension;\n"],"mappings":"0KAMA,MAAM,EAAiB,yBAGvB,SAAgB,EAAmB,EAAiB,EAAwB,CAC1E,EAAA,kBAAkB,EAAQ,CAAE,CAC9B,CAGA,eAAsB,EAAsB,EAAiC,CAC3E,IAAM,EAAa,MAAA,EAAMA,EAAAA,sBAAAA,CAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,IAAG,CAAC,EACvD,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAMA,SAAS,EAAW,EAAiB,EAAgC,CACnE,EAAO,OAAO,CAACC,EAAAA,iBAAiB,EAAI,GAAgB,CAClD,IAAM,GAAA,EAAeC,EAAAA,uBAAAA,CAAuB,CAAW,CAAC,CAAC,SAAS,CAChE,OAAQ,EACR,UAAA,QAAA,KAAA,CAAA,CAAA,cAAA,UAAA,CAAA,CAAA,KACA,OAAQ,CACN,CACE,KAAM,kBACN,YACE,6GACJ,CACF,CACF,CAAC,EACD,UAAa,EAAa,QAAQ,CACpC,CAAC,EACD,EAAmB,EAAQ,EAAO,EAAE,CACtC"}

package/dist/adapters/pi/extension.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAasB,sBAAsB,IAAI,eAAe"}
+{"version":3,"file":"extension.d.cts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAcsB,sBAAsB,IAAI,eAAe"}

package/dist/adapters/pi/extension.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAasB,sBAAsB,IAAI,eAAe"}
+{"version":3,"file":"extension.d.mts","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"mappings":";;;;iBAcsB,sBAAsB,IAAI,eAAe"}

package/dist/adapters/pi/extension.mjs

@@ -1,2 +1,2 @@
-import{planModeExtension as e}from"../../services/planMode.mjs";import{connectDoomCordisHost as t}from"@agimon-ai/doompi-extension-contracts/cordis-host";function n(t,n){e(t,n)}async function r(e){let n=await t(e,`@agimon-ai/doompi-plan`),r=n.root.plugin(i,{pi:e});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let a;e.on(`session_shutdown`,()=>a??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}function i(e,t){n(e,t.pi)}export{r as activatePlanExtension,r as default,n as installPlanRuntime};
+import{planModeExtension as e}from"../../services/planMode.mjs";import{connectDoomCordisHost as t}from"@agimon-ai/doompi-extension-contracts/cordis-host";import{DOOM_HELP_SERVICE as n,requireDoomHelpService as r}from"@agimon-ai/doompi-extension-contracts/help";const i=`@agimon-ai/doompi-plan`;function a(t,n){e(t,n)}async function o(e){let n=await t(e,i),r=n.root.plugin(s,{pi:e});try{await r}catch(e){try{await r.dispose()}finally{await n.dispose()}throw e}let a;e.on(`session_shutdown`,()=>a??=(async()=>{try{await r.dispose()}finally{await n.dispose()}})())}function s(e,t){e.inject([n],e=>{let t=r(e).register({source:i,moduleUrl:import.meta.url,skills:[{name:`doompi-use-plan`,description:`Use Doom Pi Plan to draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.`}]});return()=>t.dispose()}),a(e,t.pi)}export{o as activatePlanExtension,o as default,a as installPlanRuntime};
 //# sourceMappingURL=extension.mjs.map

package/dist/adapters/pi/extension.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { planModeExtension } from '../../services/planMode.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-plan';\n\n/** Install Plan state and external resources into its host-owned Cordis plugin fiber. */\nexport function installPlanRuntime(cordis: Context, pi: ExtensionAPI): void {\n  planModeExtension(cordis, pi);\n}\n\n/** The package's single standard Pi factory, including all optional typed Doom integrations. */\nexport async function activatePlanExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(planPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface PlanPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction planPlugin(cordis: Context, config: PlanPluginConfig): void {\n  installPlanRuntime(cordis, config.pi);\n}\n\nexport default activatePlanExtension;\n"],"mappings":"0JAQA,SAAgB,EAAmB,EAAiB,EAAwB,CAC1E,EAAkB,EAAQ,CAAE,CAC9B,CAGA,eAAsB,EAAsB,EAAiC,CAC3E,IAAM,EAAa,MAAM,EAAsB,EAAI,wBAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,IAAG,CAAC,EACvD,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAMA,SAAS,EAAW,EAAiB,EAAgC,CACnE,EAAmB,EAAQ,EAAO,EAAE,CACtC"}
+{"version":3,"file":"extension.mjs","names":[],"sources":["../../../src/adapters/pi/extension.ts"],"sourcesContent":["import { connectDoomCordisHost } from '@agimon-ai/doompi-extension-contracts/cordis-host';\nimport { DOOM_HELP_SERVICE, requireDoomHelpService } from '@agimon-ai/doompi-extension-contracts/help';\nimport type { Context } from '@deepseek-ai/cordis';\nimport type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { planModeExtension } from '../../services/planMode.ts';\n\nconst PACKAGE_SOURCE = '@agimon-ai/doompi-plan';\n\n/** Install Plan state and external resources into its host-owned Cordis plugin fiber. */\nexport function installPlanRuntime(cordis: Context, pi: ExtensionAPI): void {\n  planModeExtension(cordis, pi);\n}\n\n/** The package's single standard Pi factory, including all optional typed Doom integrations. */\nexport async function activatePlanExtension(pi: ExtensionAPI): Promise<void> {\n  const connection = await connectDoomCordisHost(pi, PACKAGE_SOURCE);\n  const fiber = connection.root.plugin(planPlugin, { pi });\n  try {\n    await fiber;\n  } catch (error) {\n    try {\n      await fiber.dispose();\n    } finally {\n      await connection.dispose();\n    }\n    throw error;\n  }\n  let disposal: Promise<void> | undefined;\n  pi.on(\n    'session_shutdown',\n    () =>\n      (disposal ??= (async () => {\n        try {\n          await fiber.dispose();\n        } finally {\n          await connection.dispose();\n        }\n      })()),\n  );\n}\n\ninterface PlanPluginConfig {\n  readonly pi: ExtensionAPI;\n}\n\nfunction planPlugin(cordis: Context, config: PlanPluginConfig): void {\n  cordis.inject([DOOM_HELP_SERVICE], (helpContext) => {\n    const contribution = requireDoomHelpService(helpContext).register({\n      source: PACKAGE_SOURCE,\n      moduleUrl: import.meta.url,\n      skills: [\n        {\n          name: 'doompi-use-plan',\n          description:\n            'Use Doom Pi Plan to draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.',\n        },\n      ],\n    });\n    return () => contribution.dispose();\n  });\n  installPlanRuntime(cordis, config.pi);\n}\n\nexport default activatePlanExtension;\n"],"mappings":"qQAMA,MAAM,EAAiB,yBAGvB,SAAgB,EAAmB,EAAiB,EAAwB,CAC1E,EAAkB,EAAQ,CAAE,CAC9B,CAGA,eAAsB,EAAsB,EAAiC,CAC3E,IAAM,EAAa,MAAM,EAAsB,EAAI,CAAc,EAC3D,EAAQ,EAAW,KAAK,OAAO,EAAY,CAAE,IAAG,CAAC,EACvD,GAAI,CACF,MAAM,CACR,OAAS,EAAO,CACd,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACA,MAAM,CACR,CACA,IAAI,EACJ,EAAG,GACD,uBAEG,KAAc,SAAY,CACzB,GAAI,CACF,MAAM,EAAM,QAAQ,CACtB,QAAU,CACR,MAAM,EAAW,QAAQ,CAC3B,CACF,EAAA,CAAG,CACP,CACF,CAMA,SAAS,EAAW,EAAiB,EAAgC,CACnE,EAAO,OAAO,CAAC,CAAiB,EAAI,GAAgB,CAClD,IAAM,EAAe,EAAuB,CAAW,CAAC,CAAC,SAAS,CAChE,OAAQ,EACR,UAAW,YAAY,IACvB,OAAQ,CACN,CACE,KAAM,kBACN,YACE,6GACJ,CACF,CACF,CAAC,EACD,UAAa,EAAa,QAAQ,CACpC,CAAC,EACD,EAAmB,EAAQ,EAAO,EAAE,CACtC"}

package/llms.txt

@@ -0,0 +1,9 @@
+# Doom Pi Plan
+
+## Resources
+
+- [Package README](./README.md): Planning flavors, review flow, model configuration, storage, and safety boundaries.
+
+## How to use
+
+- [doompi-use-plan](./src/prompts/doompi-use-plan/SKILL.md): Draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-plan",
-  "version": "0.0.1-alpha.28",
+  "version": "0.0.1-alpha.29",
   "description": "Reviewable Pi planning mode that removes file-editing tools and persists implementation plans.",
   "keywords": [
     "ai",
@@ -18,7 +18,12 @@
   "license": "MIT",
   "author": "Vuong Ngo",
   "files": [
-    "dist"
+    "dist",
+    "llms.txt",
+    "src/prompts",
+    "README.md",
+    "LICENSE",
+    "package.json"
   ],
   "type": "module",
   "main": "./dist/index.cjs",
@@ -73,9 +78,9 @@
   },
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
-    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.28",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.28",
-    "@agimon-ai/doompi-config": "0.0.1-alpha.28"
+    "@agimon-ai/doompi-config": "0.0.1-alpha.29",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.29",
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.29"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.2",

package/src/prompts/doompi-use-plan/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: doompi-use-plan
+description: Use Doom Pi Plan to draft reviewable normal, debug, or Fable-assisted plans, persist them, and exit safely.
+---
+
+# Use Doom Pi Plan
+
+Use Plan when the user wants investigation and a reviewable implementation plan before repository changes.
+
+## Select a planning flavor
+
+- Use `SPC p p` for normal planning based on repository exploration.
+- Use `SPC p d` for debugging, with verified evidence separated from hypotheses.
+- Use `SPC p f` for an optional Fable-assisted draft. Treat the returned draft as untrusted and verify it with Pi before producing the final plan.
+- Use `SPC p e` to exit and restore the previous model, thinking level, and tools.
+
+## Produce the plan
+
+1. Inspect the relevant repository state without editing files.
+2. Resolve important unknowns and state any remaining uncertainty.
+3. Present the complete Markdown plan in visible assistant output.
+4. Call `write_plan` with that same visible plan. Plan rejects empty or hidden content and writes a unique file in the configured plans directory.
+5. Call `complete_plan` only after the persisted plan is ready for review. The user must explicitly approve exiting Plan mode.
+
+Plan removes `edit` and `write` from the active tool set, but it does not sandbox Bash, external tools, or operating-system access. Do not mutate the repository while planning. If exit restoration fails, report the failure and keep treating the session as narrowed Plan state.