@avadisabelle/ava-pi-trading 0.63.1

package/README.md

@@ -0,0 +1,134 @@
+# @avadisabelle/ava-pi-trading
+
+**Williams 5D trading types, ARIANE trade gate protocol, and garden metaphor for the Ava ecosystem**
+
+This package provides the core type system and pure logic functions for implementing the Williams Method trading approach within the Ava PI ecosystem. It includes:
+
+- **Williams 5 Dimensions**: TypeScript types for the Alligator, Awesome Oscillator (AO), Acceleration/Deceleration (AC), Fractals, and Fractal Divergent Bars (FDB)
+- **ARIANE Trade Gate Protocol**: The Three Agreements framework and consensus-driven trade evaluation
+- **Garden Metaphor**: Capital-as-soil portfolio health tracking using organic farming imagery
+- **Instrument Management**: Tradeable instrument definitions and Candidate Data Series (CDS) entries
+
+## Installation
+
+```bash
+npm install @avadisabelle/ava-pi-trading
+```
+
+## Quick Start
+
+```typescript
+import {
+	evaluateGate,
+	type ThreeAgreements,
+	type TradeVerdict,
+	type WilliamsDimensions,
+	dimensionsSupportDirection,
+} from "@avadisabelle/ava-pi-trading";
+
+// Evaluate the Three Agreements to get a trade verdict
+const agreements: ThreeAgreements = {
+	trendAlignment: true,
+	signalPresence: true,
+	gardenCapacity: true,
+};
+
+const verdict: TradeVerdict = evaluateGate(agreements);
+console.log(verdict); // "ALLOW"
+
+// Check if Williams dimensions support a trade direction
+const dims: WilliamsDimensions = {
+	instrument: "EUR/USD",
+	timeframe: "H1",
+	timestamp: new Date().toISOString(),
+	alligator: {
+		jaw: 1.1000,
+		teeth: 1.1010,
+		lips: 1.1020,
+		sleeping: false,
+		direction: "bullish",
+		spread: 0.0020,
+	},
+	ao: { value: 0.0005, trend: "rising", zeroCross: true, consecutiveBars: 3 },
+	ac: { value: 0.0002, acceleration: "positive" },
+	fractals: {
+		highFractal: 1.1050,
+		lowFractal: 1.0980,
+		highFractalTime: new Date().toISOString(),
+		lowFractalTime: new Date().toISOString(),
+	},
+	zone: "green",
+	fdb: {
+		direction: "long",
+		fractalLevel: 1.0980,
+		aoConfirms: true,
+		alligatorOpen: true,
+		strength: "strong",
+		barIndex: 5,
+	},
+};
+
+const supportsLong = dimensionsSupportDirection(dims, "long");
+console.log(supportsLong); // true
+```
+
+## API Overview
+
+### Types
+
+- **`TradeDirection`**: `"long" | "short"`
+- **`TradeVerdict`**: `"ALLOW" | "WAIT" | "NO_TRADE"`
+- **`Timeframe`**: `"M1" | "M5" | "M15" | "M30" | "H1" | "H4" | "D1" | "W1" | "MN"`
+- **`SignalStrength`**: `"strong" | "moderate" | "weak"`
+- **`MarketRegime`**: `"trending" | "ranging" | "volatile" | "quiet"`
+- **`PatternStage`**: `"seed" | "sprout" | "sapling" | "tree" | "harvest" | "composting"`
+
+### Williams 5D Interfaces
+
+- **`AlligatorState`**: Jaw, teeth, lips, sleeping state, direction, and spread
+- **`AOState`**: Awesome Oscillator value, trend, zero cross, and consecutive bars
+- **`ACState`**: Acceleration/Deceleration value and acceleration direction
+- **`FractalLevels`**: High/low fractal levels and timestamps
+- **`FDBSignal`**: Fractal Divergent Bar signal details
+- **`Zone`**: Current bar zone (`"green" | "red" | "gray"`)
+- **`WilliamsDimensions`**: Complete snapshot of all 5 dimensions
+
+### Trade Gate
+
+- **`ThreeAgreements`**: Trend alignment, signal presence, and garden capacity
+- **`FaceVerdict`**: Individual council face verdict
+- **`GateAssessment`**: Complete gate assessment output
+- **`evaluateGate(agreements)`**: Pure function to evaluate the Three Agreements → verdict
+- **`dimensionsSupportDirection(dims, direction)`**: Check if Williams dimensions support a trade direction
+
+### Garden
+
+- **`GardenState`**: Portfolio health metrics using soil/planting metaphor
+- **`PatternLifecycle`**: Pattern lifecycle tracking for an instrument
+- **`gardenHasCapacity(garden)`**: Check if the garden can accept a new trade
+- **`assessWeather(volatility, trendStrength)`**: Determine market regime
+
+### Instruments
+
+- **`Instrument`**: Tradeable instrument definition
+- **`CDSEntry`**: Candidate Data Series signal entry
+
+## Relationship to `@avadisabelle/ava-council`
+
+This package depends on `@avadisabelle/ava-council` and uses its `ConsensusResult` type in the `GateAssessment` interface. The council provides the multi-face consensus mechanism that powers the ARIANE trade gate protocol.
+
+## Philosophy: The Three Agreements
+
+The ARIANE gate protocol is built on the principle of **unanimous consent**. All three agreements must hold:
+
+1. **Trend Alignment**: Higher timeframe trend supports the direction
+2. **Signal Presence**: A valid entry signal (FDB) exists on the trading timeframe
+3. **Garden Capacity**: Capital/risk allows the trade (soil health, planting density)
+
+If all three align → `ALLOW`  
+If signal or capacity is missing → `NO_TRADE`  
+Otherwise → `WAIT`
+
+## License
+
+MIT © Guillaume JG Isabelle

package/dist/garden.d.ts

@@ -0,0 +1,33 @@
+import type { MarketRegime, PatternStage } from "./types.js";
+/**
+ * Garden state — the capital-as-soil metaphor.
+ * Tracks portfolio health using organic farming imagery.
+ */
+export interface GardenState {
+    /** Soil health: 0-100 (available margin / total capital) */
+    soilHealth: number;
+    /** Planting density: open positions vs maximum allowed */
+    plantingDensity: number;
+    /** Current market regime as weather */
+    weather: MarketRegime;
+    /** P&L trajectory as growth rate */
+    growthRate: number;
+    /** Total open positions */
+    openPositions: number;
+    /** Maximum positions allowed */
+    maxPositions: number;
+}
+/** Pattern lifecycle tracking for a single instrument. */
+export interface PatternLifecycle {
+    instrument: string;
+    timeframe: string;
+    stage: PatternStage;
+    enteredStageAt: string;
+    signals: string[];
+    nextMilestone: string;
+}
+/** Check if the garden has capacity for a new trade. */
+export declare function gardenHasCapacity(garden: GardenState): boolean;
+/** Assess garden weather from market conditions. */
+export declare function assessWeather(volatility: number, trendStrength: number): MarketRegime;
+//# sourceMappingURL=garden.d.ts.map

package/dist/garden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garden.d.ts","sourceRoot":"","sources":["../src/garden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,OAAO,EAAE,YAAY,CAAC;IACtB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAKrF","sourcesContent":["import type { MarketRegime, PatternStage } from \"./types.js\";\n\n/**\n * Garden state — the capital-as-soil metaphor.\n * Tracks portfolio health using organic farming imagery.\n */\nexport interface GardenState {\n\t/** Soil health: 0-100 (available margin / total capital) */\n\tsoilHealth: number;\n\t/** Planting density: open positions vs maximum allowed */\n\tplantingDensity: number;\n\t/** Current market regime as weather */\n\tweather: MarketRegime;\n\t/** P&L trajectory as growth rate */\n\tgrowthRate: number;\n\t/** Total open positions */\n\topenPositions: number;\n\t/** Maximum positions allowed */\n\tmaxPositions: number;\n}\n\n/** Pattern lifecycle tracking for a single instrument. */\nexport interface PatternLifecycle {\n\tinstrument: string;\n\ttimeframe: string;\n\tstage: PatternStage;\n\tenteredStageAt: string;\n\tsignals: string[];\n\tnextMilestone: string;\n}\n\n/** Check if the garden has capacity for a new trade. */\nexport function gardenHasCapacity(garden: GardenState): boolean {\n\treturn garden.soilHealth > 20 && garden.plantingDensity < 0.8 && garden.openPositions < garden.maxPositions;\n}\n\n/** Assess garden weather from market conditions. */\nexport function assessWeather(volatility: number, trendStrength: number): MarketRegime {\n\tif (volatility > 0.7) return \"volatile\";\n\tif (trendStrength > 0.6) return \"trending\";\n\tif (volatility < 0.2 && trendStrength < 0.2) return \"quiet\";\n\treturn \"ranging\";\n}\n"]}

package/dist/garden.js

@@ -0,0 +1,15 @@
+/** Check if the garden has capacity for a new trade. */
+export function gardenHasCapacity(garden) {
+    return garden.soilHealth > 20 && garden.plantingDensity < 0.8 && garden.openPositions < garden.maxPositions;
+}
+/** Assess garden weather from market conditions. */
+export function assessWeather(volatility, trendStrength) {
+    if (volatility > 0.7)
+        return "volatile";
+    if (trendStrength > 0.6)
+        return "trending";
+    if (volatility < 0.2 && trendStrength < 0.2)
+        return "quiet";
+    return "ranging";
+}
+//# sourceMappingURL=garden.js.map

package/dist/garden.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garden.js","sourceRoot":"","sources":["../src/garden.ts"],"names":[],"mappings":"AA+BA,wDAAwD;AACxD,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAW;IAC/D,OAAO,MAAM,CAAC,UAAU,GAAG,EAAE,IAAI,MAAM,CAAC,eAAe,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC;AAAA,CAC5G;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,aAAqB,EAAgB;IACtF,IAAI,UAAU,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,aAAa,GAAG,GAAG;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,UAAU,GAAG,GAAG,IAAI,aAAa,GAAG,GAAG;QAAE,OAAO,OAAO,CAAC;IAC5D,OAAO,SAAS,CAAC;AAAA,CACjB","sourcesContent":["import type { MarketRegime, PatternStage } from \"./types.js\";\n\n/**\n * Garden state — the capital-as-soil metaphor.\n * Tracks portfolio health using organic farming imagery.\n */\nexport interface GardenState {\n\t/** Soil health: 0-100 (available margin / total capital) */\n\tsoilHealth: number;\n\t/** Planting density: open positions vs maximum allowed */\n\tplantingDensity: number;\n\t/** Current market regime as weather */\n\tweather: MarketRegime;\n\t/** P&L trajectory as growth rate */\n\tgrowthRate: number;\n\t/** Total open positions */\n\topenPositions: number;\n\t/** Maximum positions allowed */\n\tmaxPositions: number;\n}\n\n/** Pattern lifecycle tracking for a single instrument. */\nexport interface PatternLifecycle {\n\tinstrument: string;\n\ttimeframe: string;\n\tstage: PatternStage;\n\tenteredStageAt: string;\n\tsignals: string[];\n\tnextMilestone: string;\n}\n\n/** Check if the garden has capacity for a new trade. */\nexport function gardenHasCapacity(garden: GardenState): boolean {\n\treturn garden.soilHealth > 20 && garden.plantingDensity < 0.8 && garden.openPositions < garden.maxPositions;\n}\n\n/** Assess garden weather from market conditions. */\nexport function assessWeather(volatility: number, trendStrength: number): MarketRegime {\n\tif (volatility > 0.7) return \"volatile\";\n\tif (trendStrength > 0.6) return \"trending\";\n\tif (volatility < 0.2 && trendStrength < 0.2) return \"quiet\";\n\treturn \"ranging\";\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { GardenState, PatternLifecycle } from "./garden.js";
+export { assessWeather, gardenHasCapacity } from "./garden.js";
+export type { CDSEntry, Instrument } from "./instruments.js";
+export type { FaceVerdict, GateAssessment, ThreeAgreements } from "./trade-gate.js";
+export { dimensionsSupportDirection, evaluateGate } from "./trade-gate.js";
+export type { MarketRegime, PatternStage, SignalStrength, Timeframe, TradeDirection, TradeVerdict, } from "./types.js";
+export type { ACState, AlligatorState, AOState, FDBSignal, FractalLevels, WilliamsDimensions, Zone, } from "./williams-5d.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7D,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3E,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,EACT,cAAc,EACd,YAAY,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACX,OAAO,EACP,cAAc,EACd,OAAO,EACP,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,IAAI,GACJ,MAAM,kBAAkB,CAAC","sourcesContent":["// Types\n\n// Garden\nexport type { GardenState, PatternLifecycle } from \"./garden.js\";\nexport { assessWeather, gardenHasCapacity } from \"./garden.js\";\n// Instruments\nexport type { CDSEntry, Instrument } from \"./instruments.js\";\n// Trade Gate\nexport type { FaceVerdict, GateAssessment, ThreeAgreements } from \"./trade-gate.js\";\nexport { dimensionsSupportDirection, evaluateGate } from \"./trade-gate.js\";\nexport type {\n\tMarketRegime,\n\tPatternStage,\n\tSignalStrength,\n\tTimeframe,\n\tTradeDirection,\n\tTradeVerdict,\n} from \"./types.js\";\n// Williams 5D\nexport type {\n\tACState,\n\tAlligatorState,\n\tAOState,\n\tFDBSignal,\n\tFractalLevels,\n\tWilliamsDimensions,\n\tZone,\n} from \"./williams-5d.js\";\n"]}

package/dist/index.js

@@ -0,0 +1,4 @@
+// Types
+export { assessWeather, gardenHasCapacity } from "./garden.js";
+export { dimensionsSupportDirection, evaluateGate } from "./trade-gate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AAIR,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAK/D,OAAO,EAAE,0BAA0B,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["// Types\n\n// Garden\nexport type { GardenState, PatternLifecycle } from \"./garden.js\";\nexport { assessWeather, gardenHasCapacity } from \"./garden.js\";\n// Instruments\nexport type { CDSEntry, Instrument } from \"./instruments.js\";\n// Trade Gate\nexport type { FaceVerdict, GateAssessment, ThreeAgreements } from \"./trade-gate.js\";\nexport { dimensionsSupportDirection, evaluateGate } from \"./trade-gate.js\";\nexport type {\n\tMarketRegime,\n\tPatternStage,\n\tSignalStrength,\n\tTimeframe,\n\tTradeDirection,\n\tTradeVerdict,\n} from \"./types.js\";\n// Williams 5D\nexport type {\n\tACState,\n\tAlligatorState,\n\tAOState,\n\tFDBSignal,\n\tFractalLevels,\n\tWilliamsDimensions,\n\tZone,\n} from \"./williams-5d.js\";\n"]}

package/dist/instruments.d.ts

@@ -0,0 +1,20 @@
+import type { Timeframe } from "./types.js";
+/** A tradeable instrument in the universe. */
+export interface Instrument {
+    symbol: string;
+    name: string;
+    type: "forex" | "index" | "commodity" | "crypto";
+    pipSize: number;
+    /** Default timeframes to scan for this instrument */
+    defaultTimeframes: Timeframe[];
+}
+/** CDS (Candidate Data Series) entry — the signal detection layer. */
+export interface CDSEntry {
+    instrument: string;
+    timeframe: Timeframe;
+    timestamp: string;
+    signalType: string;
+    signalStrength: number;
+    metadata: Record<string, unknown>;
+}
+//# sourceMappingURL=instruments.d.ts.map

package/dist/instruments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.d.ts","sourceRoot":"","sources":["../src/instruments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,iBAAiB,EAAE,SAAS,EAAE,CAAC;CAC/B;AAED,wEAAsE;AACtE,MAAM,WAAW,QAAQ;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC","sourcesContent":["import type { Timeframe } from \"./types.js\";\n\n/** A tradeable instrument in the universe. */\nexport interface Instrument {\n\tsymbol: string;\n\tname: string;\n\ttype: \"forex\" | \"index\" | \"commodity\" | \"crypto\";\n\tpipSize: number;\n\t/** Default timeframes to scan for this instrument */\n\tdefaultTimeframes: Timeframe[];\n}\n\n/** CDS (Candidate Data Series) entry — the signal detection layer. */\nexport interface CDSEntry {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\ttimestamp: string;\n\tsignalType: string;\n\tsignalStrength: number;\n\tmetadata: Record<string, unknown>;\n}\n"]}

package/dist/instruments.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=instruments.js.map

package/dist/instruments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments.js","sourceRoot":"","sources":["../src/instruments.ts"],"names":[],"mappings":"","sourcesContent":["import type { Timeframe } from \"./types.js\";\n\n/** A tradeable instrument in the universe. */\nexport interface Instrument {\n\tsymbol: string;\n\tname: string;\n\ttype: \"forex\" | \"index\" | \"commodity\" | \"crypto\";\n\tpipSize: number;\n\t/** Default timeframes to scan for this instrument */\n\tdefaultTimeframes: Timeframe[];\n}\n\n/** CDS (Candidate Data Series) entry — the signal detection layer. */\nexport interface CDSEntry {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\ttimestamp: string;\n\tsignalType: string;\n\tsignalStrength: number;\n\tmetadata: Record<string, unknown>;\n}\n"]}

package/dist/trade-gate.d.ts

@@ -0,0 +1,42 @@
+import type { ConsensusResult } from "@avadisabelle/ava-council";
+import type { Timeframe, TradeDirection, TradeVerdict } from "./types.js";
+import type { WilliamsDimensions } from "./williams-5d.js";
+/**
+ * The Three Agreements — the core decision framework.
+ * All three must align for ALLOW. Any disagreement produces WAIT or NO_TRADE.
+ */
+export interface ThreeAgreements {
+    /** Agreement 1: Higher timeframe trend supports the direction */
+    trendAlignment: boolean;
+    /** Agreement 2: A valid entry signal (FDB) exists on the trading timeframe */
+    signalPresence: boolean;
+    /** Agreement 3: Capital/risk allows the trade (garden has capacity) */
+    gardenCapacity: boolean;
+}
+/** Individual face verdict in the council assessment. */
+export interface FaceVerdict {
+    faceId: string;
+    faceName: string;
+    verdict: TradeVerdict;
+    reasoning: string;
+    confidence: number;
+}
+/**
+ * Complete gate assessment — the output of the ARIANE protocol.
+ */
+export interface GateAssessment {
+    instrument: string;
+    timeframe: Timeframe;
+    direction: TradeDirection;
+    verdict: TradeVerdict;
+    agreements: ThreeAgreements;
+    faces: FaceVerdict[];
+    consensus: ConsensusResult | null;
+    reasoning: string;
+    timestamp: string;
+}
+/** Evaluate the Three Agreements and produce a verdict. Pure logic — no MCP calls, no side effects. */
+export declare function evaluateGate(agreements: ThreeAgreements): TradeVerdict;
+/** Check if Williams dimensions support a trade direction. */
+export declare function dimensionsSupportDirection(dims: WilliamsDimensions, direction: TradeDirection): boolean;
+//# sourceMappingURL=trade-gate.d.ts.map

package/dist/trade-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-gate.d.ts","sourceRoot":"","sources":["../src/trade-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,iEAAiE;IACjE,cAAc,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,yGAAuG;AACvG,wBAAgB,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,YAAY,CAYtE;AAED,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAWvG","sourcesContent":["import type { ConsensusResult } from \"@avadisabelle/ava-council\";\nimport type { Timeframe, TradeDirection, TradeVerdict } from \"./types.js\";\nimport type { WilliamsDimensions } from \"./williams-5d.js\";\n\n/**\n * The Three Agreements — the core decision framework.\n * All three must align for ALLOW. Any disagreement produces WAIT or NO_TRADE.\n */\nexport interface ThreeAgreements {\n\t/** Agreement 1: Higher timeframe trend supports the direction */\n\ttrendAlignment: boolean;\n\t/** Agreement 2: A valid entry signal (FDB) exists on the trading timeframe */\n\tsignalPresence: boolean;\n\t/** Agreement 3: Capital/risk allows the trade (garden has capacity) */\n\tgardenCapacity: boolean;\n}\n\n/** Individual face verdict in the council assessment. */\nexport interface FaceVerdict {\n\tfaceId: string;\n\tfaceName: string;\n\tverdict: TradeVerdict;\n\treasoning: string;\n\tconfidence: number;\n}\n\n/**\n * Complete gate assessment — the output of the ARIANE protocol.\n */\nexport interface GateAssessment {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\tdirection: TradeDirection;\n\tverdict: TradeVerdict;\n\tagreements: ThreeAgreements;\n\tfaces: FaceVerdict[];\n\tconsensus: ConsensusResult | null;\n\treasoning: string;\n\ttimestamp: string;\n}\n\n/** Evaluate the Three Agreements and produce a verdict. Pure logic — no MCP calls, no side effects. */\nexport function evaluateGate(agreements: ThreeAgreements): TradeVerdict {\n\tconst { trendAlignment, signalPresence, gardenCapacity } = agreements;\n\n\tif (trendAlignment && signalPresence && gardenCapacity) {\n\t\treturn \"ALLOW\";\n\t}\n\n\tif (!signalPresence || !gardenCapacity) {\n\t\treturn \"NO_TRADE\";\n\t}\n\n\treturn \"WAIT\";\n}\n\n/** Check if Williams dimensions support a trade direction. */\nexport function dimensionsSupportDirection(dims: WilliamsDimensions, direction: TradeDirection): boolean {\n\tconst alligatorSupports =\n\t\t!dims.alligator.sleeping &&\n\t\t((direction === \"long\" && dims.alligator.direction === \"bullish\") ||\n\t\t\t(direction === \"short\" && dims.alligator.direction === \"bearish\"));\n\n\tconst aoSupports = (direction === \"long\" && dims.ao.value > 0) || (direction === \"short\" && dims.ao.value < 0);\n\n\tconst fdbPresent = dims.fdb !== null && dims.fdb.direction === direction;\n\n\treturn alligatorSupports && aoSupports && fdbPresent;\n}\n"]}

package/dist/trade-gate.js

@@ -0,0 +1,21 @@
+/** Evaluate the Three Agreements and produce a verdict. Pure logic — no MCP calls, no side effects. */
+export function evaluateGate(agreements) {
+    const { trendAlignment, signalPresence, gardenCapacity } = agreements;
+    if (trendAlignment && signalPresence && gardenCapacity) {
+        return "ALLOW";
+    }
+    if (!signalPresence || !gardenCapacity) {
+        return "NO_TRADE";
+    }
+    return "WAIT";
+}
+/** Check if Williams dimensions support a trade direction. */
+export function dimensionsSupportDirection(dims, direction) {
+    const alligatorSupports = !dims.alligator.sleeping &&
+        ((direction === "long" && dims.alligator.direction === "bullish") ||
+            (direction === "short" && dims.alligator.direction === "bearish"));
+    const aoSupports = (direction === "long" && dims.ao.value > 0) || (direction === "short" && dims.ao.value < 0);
+    const fdbPresent = dims.fdb !== null && dims.fdb.direction === direction;
+    return alligatorSupports && aoSupports && fdbPresent;
+}
+//# sourceMappingURL=trade-gate.js.map

package/dist/trade-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade-gate.js","sourceRoot":"","sources":["../src/trade-gate.ts"],"names":[],"mappings":"AAyCA,yGAAuG;AACvG,MAAM,UAAU,YAAY,CAAC,UAA2B,EAAgB;IACvE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC;IAEtE,IAAI,cAAc,IAAI,cAAc,IAAI,cAAc,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAAA,CACd;AAED,8DAA8D;AAC9D,MAAM,UAAU,0BAA0B,CAAC,IAAwB,EAAE,SAAyB,EAAW;IACxG,MAAM,iBAAiB,GACtB,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ;QACxB,CAAC,CAAC,SAAS,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC;YAChE,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC;IAErE,MAAM,UAAU,GAAG,CAAC,SAAS,KAAK,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAE/G,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;IAEzE,OAAO,iBAAiB,IAAI,UAAU,IAAI,UAAU,CAAC;AAAA,CACrD","sourcesContent":["import type { ConsensusResult } from \"@avadisabelle/ava-council\";\nimport type { Timeframe, TradeDirection, TradeVerdict } from \"./types.js\";\nimport type { WilliamsDimensions } from \"./williams-5d.js\";\n\n/**\n * The Three Agreements — the core decision framework.\n * All three must align for ALLOW. Any disagreement produces WAIT or NO_TRADE.\n */\nexport interface ThreeAgreements {\n\t/** Agreement 1: Higher timeframe trend supports the direction */\n\ttrendAlignment: boolean;\n\t/** Agreement 2: A valid entry signal (FDB) exists on the trading timeframe */\n\tsignalPresence: boolean;\n\t/** Agreement 3: Capital/risk allows the trade (garden has capacity) */\n\tgardenCapacity: boolean;\n}\n\n/** Individual face verdict in the council assessment. */\nexport interface FaceVerdict {\n\tfaceId: string;\n\tfaceName: string;\n\tverdict: TradeVerdict;\n\treasoning: string;\n\tconfidence: number;\n}\n\n/**\n * Complete gate assessment — the output of the ARIANE protocol.\n */\nexport interface GateAssessment {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\tdirection: TradeDirection;\n\tverdict: TradeVerdict;\n\tagreements: ThreeAgreements;\n\tfaces: FaceVerdict[];\n\tconsensus: ConsensusResult | null;\n\treasoning: string;\n\ttimestamp: string;\n}\n\n/** Evaluate the Three Agreements and produce a verdict. Pure logic — no MCP calls, no side effects. */\nexport function evaluateGate(agreements: ThreeAgreements): TradeVerdict {\n\tconst { trendAlignment, signalPresence, gardenCapacity } = agreements;\n\n\tif (trendAlignment && signalPresence && gardenCapacity) {\n\t\treturn \"ALLOW\";\n\t}\n\n\tif (!signalPresence || !gardenCapacity) {\n\t\treturn \"NO_TRADE\";\n\t}\n\n\treturn \"WAIT\";\n}\n\n/** Check if Williams dimensions support a trade direction. */\nexport function dimensionsSupportDirection(dims: WilliamsDimensions, direction: TradeDirection): boolean {\n\tconst alligatorSupports =\n\t\t!dims.alligator.sleeping &&\n\t\t((direction === \"long\" && dims.alligator.direction === \"bullish\") ||\n\t\t\t(direction === \"short\" && dims.alligator.direction === \"bearish\"));\n\n\tconst aoSupports = (direction === \"long\" && dims.ao.value > 0) || (direction === \"short\" && dims.ao.value < 0);\n\n\tconst fdbPresent = dims.fdb !== null && dims.fdb.direction === direction;\n\n\treturn alligatorSupports && aoSupports && fdbPresent;\n}\n"]}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+/** Trade direction */
+export type TradeDirection = "long" | "short";
+/** Trade verdict — the output of the gate protocol */
+export type TradeVerdict = "ALLOW" | "WAIT" | "NO_TRADE";
+/** Timeframes used in the Williams Method hierarchy */
+export type Timeframe = "M1" | "M5" | "M15" | "M30" | "H1" | "H4" | "D1" | "W1" | "MN";
+/** Signal strength assessment */
+export type SignalStrength = "strong" | "moderate" | "weak";
+/** Market regime (garden weather) */
+export type MarketRegime = "trending" | "ranging" | "volatile" | "quiet";
+/** Pattern lifecycle stage (seed → sprout → tree) */
+export type PatternStage = "seed" | "sprout" | "sapling" | "tree" | "harvest" | "composting";
+//# 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":"AAAA,sBAAsB;AACtB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9C,wDAAsD;AACtD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;AAEzD,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvF,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEzE,yDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC","sourcesContent":["/** Trade direction */\nexport type TradeDirection = \"long\" | \"short\";\n\n/** Trade verdict — the output of the gate protocol */\nexport type TradeVerdict = \"ALLOW\" | \"WAIT\" | \"NO_TRADE\";\n\n/** Timeframes used in the Williams Method hierarchy */\nexport type Timeframe = \"M1\" | \"M5\" | \"M15\" | \"M30\" | \"H1\" | \"H4\" | \"D1\" | \"W1\" | \"MN\";\n\n/** Signal strength assessment */\nexport type SignalStrength = \"strong\" | \"moderate\" | \"weak\";\n\n/** Market regime (garden weather) */\nexport type MarketRegime = \"trending\" | \"ranging\" | \"volatile\" | \"quiet\";\n\n/** Pattern lifecycle stage (seed → sprout → tree) */\nexport type PatternStage = \"seed\" | \"sprout\" | \"sapling\" | \"tree\" | \"harvest\" | \"composting\";\n"]}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/** Trade direction */\nexport type TradeDirection = \"long\" | \"short\";\n\n/** Trade verdict — the output of the gate protocol */\nexport type TradeVerdict = \"ALLOW\" | \"WAIT\" | \"NO_TRADE\";\n\n/** Timeframes used in the Williams Method hierarchy */\nexport type Timeframe = \"M1\" | \"M5\" | \"M15\" | \"M30\" | \"H1\" | \"H4\" | \"D1\" | \"W1\" | \"MN\";\n\n/** Signal strength assessment */\nexport type SignalStrength = \"strong\" | \"moderate\" | \"weak\";\n\n/** Market regime (garden weather) */\nexport type MarketRegime = \"trending\" | \"ranging\" | \"volatile\" | \"quiet\";\n\n/** Pattern lifecycle stage (seed → sprout → tree) */\nexport type PatternStage = \"seed\" | \"sprout\" | \"sapling\" | \"tree\" | \"harvest\" | \"composting\";\n"]}

package/dist/williams-5d.d.ts

@@ -0,0 +1,74 @@
+import type { SignalStrength, Timeframe, TradeDirection } from "./types.js";
+/**
+ * Alligator indicator state.
+ * The Alligator's jaw, teeth, and lips determine trend state.
+ */
+export interface AlligatorState {
+    jaw: number;
+    teeth: number;
+    lips: number;
+    sleeping: boolean;
+    direction: "bullish" | "bearish" | "neutral";
+    /** Distance between jaw and lips — wider = stronger trend */
+    spread: number;
+}
+/**
+ * Awesome Oscillator (AO) state.
+ * Measures market momentum as the difference between 5-period and 34-period SMAs.
+ */
+export interface AOState {
+    value: number;
+    trend: "rising" | "falling" | "flat";
+    /** Whether AO crossed zero recently */
+    zeroCross: boolean;
+    /** Number of consecutive same-color bars */
+    consecutiveBars: number;
+}
+/**
+ * Acceleration/Deceleration Oscillator (AC) state.
+ * Measures acceleration of momentum change.
+ */
+export interface ACState {
+    value: number;
+    acceleration: "positive" | "negative";
+}
+/**
+ * Fractal levels — key support/resistance markers.
+ */
+export interface FractalLevels {
+    highFractal: number | null;
+    lowFractal: number | null;
+    /** Recent fractal formation timestamps */
+    highFractalTime: string | null;
+    lowFractalTime: string | null;
+}
+/**
+ * Fractal Divergent Bar (FDB) — the primary entry signal in Williams Method.
+ * An FDB occurs when a fractal forms with divergent momentum.
+ */
+export interface FDBSignal {
+    direction: TradeDirection;
+    fractalLevel: number;
+    aoConfirms: boolean;
+    alligatorOpen: boolean;
+    strength: SignalStrength;
+    /** Bar index where the FDB was detected */
+    barIndex: number;
+}
+/** Zone — the coloring of the current bar based on AO + AC alignment. */
+export type Zone = "green" | "red" | "gray";
+/**
+ * Complete Williams 5 Dimensions snapshot for an instrument/timeframe.
+ */
+export interface WilliamsDimensions {
+    instrument: string;
+    timeframe: Timeframe;
+    timestamp: string;
+    alligator: AlligatorState;
+    ao: AOState;
+    ac: ACState;
+    fractals: FractalLevels;
+    zone: Zone;
+    fdb: FDBSignal | null;
+}
+//# sourceMappingURL=williams-5d.d.ts.map

package/dist/williams-5d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"williams-5d.d.ts","sourceRoot":"","sources":["../src/williams-5d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,+DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0CAA0C;IAC1C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,SAAS,EAAE,cAAc,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,2EAAyE;AACzE,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,cAAc,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;CACtB","sourcesContent":["import type { SignalStrength, Timeframe, TradeDirection } from \"./types.js\";\n\n/**\n * Alligator indicator state.\n * The Alligator's jaw, teeth, and lips determine trend state.\n */\nexport interface AlligatorState {\n\tjaw: number;\n\tteeth: number;\n\tlips: number;\n\tsleeping: boolean;\n\tdirection: \"bullish\" | \"bearish\" | \"neutral\";\n\t/** Distance between jaw and lips — wider = stronger trend */\n\tspread: number;\n}\n\n/**\n * Awesome Oscillator (AO) state.\n * Measures market momentum as the difference between 5-period and 34-period SMAs.\n */\nexport interface AOState {\n\tvalue: number;\n\ttrend: \"rising\" | \"falling\" | \"flat\";\n\t/** Whether AO crossed zero recently */\n\tzeroCross: boolean;\n\t/** Number of consecutive same-color bars */\n\tconsecutiveBars: number;\n}\n\n/**\n * Acceleration/Deceleration Oscillator (AC) state.\n * Measures acceleration of momentum change.\n */\nexport interface ACState {\n\tvalue: number;\n\tacceleration: \"positive\" | \"negative\";\n}\n\n/**\n * Fractal levels — key support/resistance markers.\n */\nexport interface FractalLevels {\n\thighFractal: number | null;\n\tlowFractal: number | null;\n\t/** Recent fractal formation timestamps */\n\thighFractalTime: string | null;\n\tlowFractalTime: string | null;\n}\n\n/**\n * Fractal Divergent Bar (FDB) — the primary entry signal in Williams Method.\n * An FDB occurs when a fractal forms with divergent momentum.\n */\nexport interface FDBSignal {\n\tdirection: TradeDirection;\n\tfractalLevel: number;\n\taoConfirms: boolean;\n\talligatorOpen: boolean;\n\tstrength: SignalStrength;\n\t/** Bar index where the FDB was detected */\n\tbarIndex: number;\n}\n\n/** Zone — the coloring of the current bar based on AO + AC alignment. */\nexport type Zone = \"green\" | \"red\" | \"gray\";\n\n/**\n * Complete Williams 5 Dimensions snapshot for an instrument/timeframe.\n */\nexport interface WilliamsDimensions {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\ttimestamp: string;\n\talligator: AlligatorState;\n\tao: AOState;\n\tac: ACState;\n\tfractals: FractalLevels;\n\tzone: Zone;\n\tfdb: FDBSignal | null;\n}\n"]}

package/dist/williams-5d.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=williams-5d.js.map

package/dist/williams-5d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"williams-5d.js","sourceRoot":"","sources":["../src/williams-5d.ts"],"names":[],"mappings":"","sourcesContent":["import type { SignalStrength, Timeframe, TradeDirection } from \"./types.js\";\n\n/**\n * Alligator indicator state.\n * The Alligator's jaw, teeth, and lips determine trend state.\n */\nexport interface AlligatorState {\n\tjaw: number;\n\tteeth: number;\n\tlips: number;\n\tsleeping: boolean;\n\tdirection: \"bullish\" | \"bearish\" | \"neutral\";\n\t/** Distance between jaw and lips — wider = stronger trend */\n\tspread: number;\n}\n\n/**\n * Awesome Oscillator (AO) state.\n * Measures market momentum as the difference between 5-period and 34-period SMAs.\n */\nexport interface AOState {\n\tvalue: number;\n\ttrend: \"rising\" | \"falling\" | \"flat\";\n\t/** Whether AO crossed zero recently */\n\tzeroCross: boolean;\n\t/** Number of consecutive same-color bars */\n\tconsecutiveBars: number;\n}\n\n/**\n * Acceleration/Deceleration Oscillator (AC) state.\n * Measures acceleration of momentum change.\n */\nexport interface ACState {\n\tvalue: number;\n\tacceleration: \"positive\" | \"negative\";\n}\n\n/**\n * Fractal levels — key support/resistance markers.\n */\nexport interface FractalLevels {\n\thighFractal: number | null;\n\tlowFractal: number | null;\n\t/** Recent fractal formation timestamps */\n\thighFractalTime: string | null;\n\tlowFractalTime: string | null;\n}\n\n/**\n * Fractal Divergent Bar (FDB) — the primary entry signal in Williams Method.\n * An FDB occurs when a fractal forms with divergent momentum.\n */\nexport interface FDBSignal {\n\tdirection: TradeDirection;\n\tfractalLevel: number;\n\taoConfirms: boolean;\n\talligatorOpen: boolean;\n\tstrength: SignalStrength;\n\t/** Bar index where the FDB was detected */\n\tbarIndex: number;\n}\n\n/** Zone — the coloring of the current bar based on AO + AC alignment. */\nexport type Zone = \"green\" | \"red\" | \"gray\";\n\n/**\n * Complete Williams 5 Dimensions snapshot for an instrument/timeframe.\n */\nexport interface WilliamsDimensions {\n\tinstrument: string;\n\ttimeframe: Timeframe;\n\ttimestamp: string;\n\talligator: AlligatorState;\n\tao: AOState;\n\tac: ACState;\n\tfractals: FractalLevels;\n\tzone: Zone;\n\tfdb: FDBSignal | null;\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "@avadisabelle/ava-pi-trading",
+	"version": "0.63.1",
+	"description": "Williams 5D trading types, ARIANE trade gate protocol, and garden metaphor for the Ava ecosystem",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.json",
+		"dev": "tsgo -p tsconfig.json --watch --preserveWatchOutput",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"trading",
+		"williams-5d",
+		"ariane",
+		"trade-gate",
+		"fdb",
+		"alligator",
+		"garden",
+		"ava"
+	],
+	"author": "Guillaume JG Isabelle",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/avadisabelle/ava-pi.git",
+		"directory": "packages/trading"
+	},
+	"dependencies": {
+		"@avadisabelle/ava-council": "^0.63.1"
+	},
+	"devDependencies": {
+		"@types/node": "^22.10.5",
+		"typescript": "^5.9.2",
+		"vitest": "^3.2.4"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	}
+}