@medicine-wheel/prompt-decomposition 0.2.2

package/dist/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @medicine-wheel/prompt-decomposition — Types
+ *
+ * Ontology-enriched PDE types that bridge the ava-langchain
+ * Prompt Decomposition Engine with the Medicine Wheel ontology.
+ *
+ * Design:
+ * - Uses ontology-core DirectionName as the canonical direction type
+ * - Enriches PDE results with relational context (obligations, ceremony, OCAP)
+ * - Adds ontological metadata (Ojibwe names, seasons, acts) to decompositions
+ * - Supports relational-query traversal of dependency graphs
+ *
+ * Lineage: mcp-pde → ava-langchain-prompt-decomposition → @medicine-wheel/prompt-decomposition
+ */
+import type { DirectionName, RelationalObligation, CeremonyGuidance, NarrativeBeat } from '@medicine-wheel/ontology-core';
+/** Epistemic source hint following Wilson's four ways of knowing */
+export type EpistemicSourceHint = 'land' | 'dream' | 'code' | 'vision' | 'unknown';
+export type Urgency = 'immediate' | 'session' | 'sprint' | 'ongoing';
+export interface PrimaryIntent {
+    action: string;
+    target: string;
+    urgency: Urgency;
+    confidence: number;
+}
+export interface SecondaryIntent {
+    id: string;
+    action: string;
+    target: string;
+    implicit: boolean;
+    dependency: string | null;
+    confidence: number;
+}
+export interface ExtractionContext {
+    filesNeeded: string[];
+    toolsRequired: string[];
+    assumptions: string[];
+}
+export interface AmbiguityFlag {
+    text: string;
+    suggestion: string;
+}
+export interface ExpectedOutputs {
+    artifacts: string[];
+    updates: string[];
+    communications: string[];
+}
+export interface DirectionalInsight {
+    text: string;
+    confidence: number;
+    implicit: boolean;
+}
+/** Direction enriched with ontology-core metadata */
+export interface OntologicalDirection {
+    name: DirectionName;
+    ojibwe: string;
+    season: string;
+    act: number;
+    insights: DirectionalInsight[];
+    /** Relational obligations surfaced from this direction's analysis */
+    obligations: RelationalObligation[];
+    /** Whether ceremony is recommended for this direction */
+    ceremonyRecommended: boolean;
+}
+/** Intent enriched with relational accountability context */
+export interface RelationalIntent extends SecondaryIntent {
+    direction: DirectionName;
+    /** What relational obligations this intent carries */
+    obligations: RelationalObligation[];
+    /** Wilson alignment score for this intent (respect, reciprocity, responsibility) */
+    wilsonAlignment: number;
+}
+/** Dependency with ontological relationship typing */
+export interface OntologicalDependency {
+    fromId: string;
+    toId: string;
+    type: 'depends_on' | 'validates' | 'informs' | 'ceremonies';
+    direction: DirectionName;
+    confidence: number;
+}
+export interface OntologicalDecomposition {
+    id: string;
+    timestamp: string;
+    prompt: string;
+    /** Primary intent */
+    primary: PrimaryIntent;
+    /** Secondary intents enriched with direction + relational context */
+    secondary: RelationalIntent[];
+    /** Context requirements */
+    context: ExtractionContext;
+    /** Expected outputs */
+    outputs: ExpectedOutputs;
+    /** Four Directions analysis enriched with ontology-core metadata */
+    directions: Record<DirectionName, OntologicalDirection>;
+    /** Action stack ordered by direction flow (east → south → west → north) */
+    actionStack: ActionItem[];
+    /** Structured ambiguity flags */
+    ambiguities: AmbiguityFlag[];
+    /** Relational balance (0-1, how evenly distributed across directions) */
+    balance: number;
+    /** Dominant direction */
+    leadDirection: DirectionName;
+    /** Directions that need more attention */
+    neglectedDirections: DirectionName[];
+    /** Ceremony guidance for the decomposition */
+    ceremonyGuidance: CeremonyGuidance | null;
+    /** Whether ceremony is required before proceeding */
+    ceremonyRequired: boolean;
+    /** Aggregate Wilson alignment across all intents */
+    wilsonAlignment: number;
+    /** Narrative beats generated from the action stack */
+    narrativeBeats: NarrativeBeat[];
+}
+export interface ActionItem {
+    id: string;
+    text: string;
+    direction: DirectionName;
+    dependency: string | null;
+    completed: boolean;
+    confidence: number;
+    implicit: boolean;
+    /** Epistemic source classification for this action */
+    epistemicSource?: EpistemicSourceHint;
+    /** Epistemic weight reflecting significance (0–1) */
+    epistemicWeight?: number;
+}
+export interface StoredDecomposition {
+    id: string;
+    timestamp: string;
+    prompt: string;
+    result: OntologicalDecomposition;
+    markdownPath?: string;
+}
+export interface DecomposerOptions {
+    /** Extract implicit intents from hedging language (default true) */
+    extractImplicit?: boolean;
+    /** Map dependencies between tasks (default true) */
+    mapDependencies?: boolean;
+    /** Ceremony threshold — below this, ceremony is required (default 0.3) */
+    ceremonyThreshold?: number;
+    /** Working directory for .pde/ storage (optional) */
+    workdir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @medicine-wheel/prompt-decomposition — Types
+ *
+ * Ontology-enriched PDE types that bridge the ava-langchain
+ * Prompt Decomposition Engine with the Medicine Wheel ontology.
+ *
+ * Design:
+ * - Uses ontology-core DirectionName as the canonical direction type
+ * - Enriches PDE results with relational context (obligations, ceremony, OCAP)
+ * - Adds ontological metadata (Ojibwe names, seasons, acts) to decompositions
+ * - Supports relational-query traversal of dependency graphs
+ *
+ * Lineage: mcp-pde → ava-langchain-prompt-decomposition → @medicine-wheel/prompt-decomposition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@medicine-wheel/prompt-decomposition",
+  "version": "0.2.2",
+  "description": "Prompt Decomposition Engine for the Medicine Wheel Developer Suite — ontology-enriched intent extraction, relational dependency mapping, and ceremony-aware action stacking",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "browser": "./dist/index.browser.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "import": "./dist/index.browser.js",
+      "types": "./dist/index.browser.d.ts",
+      "require": "./dist/index.browser.js",
+      "default": "./dist/index.browser.js"
+    },
+    "./types": {
+      "import": "./dist/types.js",
+      "types": "./dist/types.d.ts",
+      "require": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "medicine-wheel",
+    "prompt-decomposition",
+    "pde",
+    "intent-extraction",
+    "four-directions",
+    "ontology",
+    "relational",
+    "ceremony",
+    "indigenous-research"
+  ],
+  "author": "IAIP Collaborative - Shawinigan, QC",
+  "license": "MIT",
+  "dependencies": {
+    "@medicine-wheel/ontology-core": "^0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}