@medicine-wheel/prompt-decomposition 0.2.2

package/README.md

@@ -0,0 +1,93 @@
+# @medicine-wheel/prompt-decomposition
+
+Ontology-enriched prompt decomposition engine for the Medicine Wheel Developer Suite.
+
+## Overview
+
+Extracts structured intents from natural language prompts and classifies them across the Four Directions (East/vision, South/analysis, West/validation, North/action). Detects implicit intents from hedging language, maps dependencies between tasks, and generates ceremony guidance when directional balance is poor.
+
+**Lineage:** `mcp-pde` → `ava-langchain-prompt-decomposition` → `@medicine-wheel/prompt-decomposition`
+
+## Installation
+
+```bash
+npm install @medicine-wheel/prompt-decomposition
+```
+
+## Usage
+
+### Basic Decomposition
+
+```typescript
+import { MedicineWheelDecomposer } from '@medicine-wheel/prompt-decomposition';
+
+const decomposer = new MedicineWheelDecomposer({
+  extractImplicit: true,
+  mapDependencies: true,
+  ceremonyThreshold: 0.3,
+});
+
+const result = decomposer.decompose(
+  'Research the ontology types, then implement the query builder, and validate with tests'
+);
+
+console.log(result.primary);           // { action: 'investigate', target: '...', urgency: 'session', confidence: 0.85 }
+console.log(result.balance);           // 0.75 (directional balance score)
+console.log(result.neglectedDirections); // ['east'] (vision direction neglected)
+console.log(result.ceremonyRequired);  // true/false
+console.log(result.actionStack);       // Ordered tasks: east→south→west→north
+```
+
+### Relational Enrichment
+
+```typescript
+import { RelationalEnricher } from '@medicine-wheel/prompt-decomposition';
+
+const enricher = new RelationalEnricher();
+const enriched = enricher.enrich(decomposition, {
+  nodes: myNodes,
+  edges: myEdges,
+  relations: myRelations,
+});
+
+console.log(enriched.relationalHealth);     // 0-1 composite score
+console.log(enriched.accountabilityGaps);   // Where attention is needed
+```
+
+### Storage
+
+```typescript
+import { saveDecomposition, loadDecomposition, listDecompositions } from '@medicine-wheel/prompt-decomposition';
+
+const stored = saveDecomposition('.', result);
+// Creates .pde/{id}.json and .pde/{id}.md
+
+const loaded = loadDecomposition('.', result.id);
+const all = listDecompositions('.');
+```
+
+## API
+
+### `MedicineWheelDecomposer`
+
+- `decompose(prompt: string): OntologicalDecomposition` — Full Four Directions decomposition
+
+### `RelationalEnricher`
+
+- `enrich(decomposition, graph): EnrichmentResult` — Enrich with graph context
+
+### Storage Functions
+
+- `saveDecomposition(workdir, result): StoredDecomposition`
+- `loadDecomposition(workdir, id): StoredDecomposition | null`
+- `listDecompositions(workdir): StoredDecomposition[]`
+- `decompositionToMarkdown(result): string`
+
+## Dependencies
+
+- `@medicine-wheel/ontology-core` ^0.1.0
+
+## License
+
+MIT
+

package/dist/decomposer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @medicine-wheel/prompt-decomposition — Decomposer
+ *
+ * Ontology-enriched prompt decomposition engine.
+ * Reuses the PDE patterns from ava-langchain-prompt-decomposition
+ * but grounds them in @medicine-wheel/ontology-core types.
+ *
+ * Design:
+ * - Keyword-based directional classification (same algorithm as langchainjs)
+ * - Intent extraction with hedging language detection (mcp-pde lineage)
+ * - Dependency mapping with directional inference
+ * - Ontological enrichment with Ojibwe names, seasons, acts, obligations
+ * - Ceremony guidance based on directional balance
+ */
+import type { OntologicalDecomposition, DecomposerOptions, EpistemicSourceHint } from './types.js';
+export declare class MedicineWheelDecomposer {
+    private readonly extractImplicit;
+    private readonly mapDependencies;
+    private readonly ceremonyThreshold;
+    constructor(options?: DecomposerOptions);
+    /**
+     * Decompose a prompt into an ontology-enriched result.
+     * Flows through Four Directions: EAST → SOUTH → WEST → NORTH
+     */
+    decompose(prompt: string): OntologicalDecomposition;
+    private classifyByDirection;
+    private scoreSegment;
+    private topDirection;
+    private extractIntents;
+    private calculateConfidence;
+    private detectUrgency;
+    private extractContext;
+    private enrichWithDirections;
+    private inferDirection;
+    private inferObligations;
+    private inferDependencies;
+    private topicsRelated;
+    private buildOntologicalDirections;
+    private assessBalance;
+    private checkCeremonyRequired;
+    private generateCeremonyGuidance;
+    private computeWilsonAlignment;
+    private detectAmbiguities;
+    private extractExpectedOutputs;
+    private buildActionStack;
+    private generateNarrativeBeats;
+}
+/**
+ * Heuristic classification of epistemic source from language patterns.
+ *
+ * Scans text for keywords associated with each of Wilson's four
+ * epistemic sources and returns the best match. Returns 'unknown'
+ * when no clear signal is present.
+ *
+ * - **land**: mentions of place, territory, walking, embodied experience
+ * - **dream**: mentions of vision, dream, intuition, liminal space
+ * - **code**: mentions of implementation, function, algorithm, structure
+ * - **vision**: mentions of intention, aspiration, future, purpose
+ */
+export declare function detectEpistemicSource(text: string): EpistemicSourceHint;
+//# sourceMappingURL=decomposer.d.ts.map

package/dist/decomposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer.d.ts","sourceRoot":"","sources":["../src/decomposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EACV,wBAAwB,EAWxB,iBAAiB,EAEjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAgEpB,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,CAAC,EAAE,iBAAiB;IAMvC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB;IAiEnD,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,cAAc;IA2EtB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,0BAA0B;IAsBlC,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,sBAAsB;CAa/B;AA4BD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAsCvE"}