pulseed 0.4.17 → 0.4.19

package/dist/platform/soil/types.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+export const SoilRouteSchema = z.enum([
+    "index",
+    "status",
+    "health",
+    "report",
+    "schedule",
+    "memory",
+    "knowledge",
+    "decision",
+    "identity",
+    "goal",
+    "task",
+    "timeline",
+    "operations",
+    "inbox",
+]);
+export const SoilKindSchema = z.enum([
+    "index",
+    "status",
+    "health",
+    "report",
+    "schedule",
+    "memory",
+    "knowledge",
+    "decision",
+    "identity",
+    "goal",
+    "task",
+    "timeline",
+    "operations",
+    "inbox",
+    "overlay",
+    "note",
+]);
+export const SoilStatusSchema = z.enum([
+    "draft",
+    "candidate",
+    "confirmed",
+    "stale",
+    "superseded",
+    "rejected",
+    "deprecated",
+    "archived",
+]);
+export const SoilSourceSchema = z.enum(["runtime", "compiled", "manual", "imported"]);
+export const SoilSourceTruthSchema = z.enum(["runtime_json", "soil", "mixed"]);
+export const SoilImportStatusSchema = z.enum(["none", "pending", "approved", "rejected"]);
+export const SoilApprovalStatusSchema = z.enum(["none", "pending", "approved", "rejected"]);
+export const SoilSourceTypeSchema = z.enum([
+    "runtime_json",
+    "controlled_md",
+    "soil_md",
+    "manual_overlay",
+    "web",
+    "tool_output",
+    "log",
+]);
+const datetimeSchema = z.preprocess((value) => {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    return value;
+}, z.string().refine((value) => !Number.isNaN(Date.parse(value)), "Must be a valid ISO-8601 datetime string"));
+export const SoilSourceRefSchema = z.object({
+    source_type: SoilSourceTypeSchema,
+    source_path: z.string().min(1),
+    source_id: z.string().min(1).optional(),
+    source_hash: z.string().min(1).optional(),
+    source_version: z.string().min(1).optional(),
+    source_uri: z.string().min(1).optional(),
+    fetched_at: datetimeSchema.optional(),
+    committed_at: datetimeSchema.optional(),
+    reliability: z.enum(["high", "medium", "low"]).optional(),
+});
+export const SoilGenerationWatermarkSchema = z.object({
+    scope: z.string().min(1),
+    source_path: z.string().min(1).optional(),
+    source_paths: z.array(z.string().min(1)).default([]),
+    source_hash: z.string().min(1).optional(),
+    source_hashes: z.array(z.string().min(1)).default([]),
+    source_version: z.string().min(1).optional(),
+    source_updated_at: datetimeSchema.optional(),
+    generated_at: datetimeSchema,
+    projection_version: z.string().min(1),
+    input_commit_ids: z.array(z.string().min(1)).default([]),
+    input_checksums: z.record(z.string()).default({}),
+});
+export const SoilManualOverlayStatusSchema = z.enum([
+    "candidate",
+    "confirmed",
+    "rejected",
+    "superseded",
+]);
+export const SoilManualOverlaySchema = z.object({
+    enabled: z.boolean().default(false),
+    status: SoilManualOverlayStatusSchema.default("candidate"),
+    overlay_id: z.string().min(1).optional(),
+    author: z.string().min(1).optional(),
+    target_ref: z.string().min(1).optional(),
+    created_at: datetimeSchema.optional(),
+    updated_at: datetimeSchema.optional(),
+    notes: z.string().optional(),
+});
+export const SoilPageFrontmatterSchema = z
+    .object({
+    soil_id: z.string().min(1),
+    kind: SoilKindSchema,
+    status: SoilStatusSchema,
+    title: z.string().min(1),
+    route: SoilRouteSchema,
+    source: SoilSourceSchema,
+    version: z.string().min(1),
+    created_at: datetimeSchema,
+    updated_at: datetimeSchema,
+    generated_at: datetimeSchema,
+    source_refs: z.array(SoilSourceRefSchema).default([]),
+    generation_watermark: SoilGenerationWatermarkSchema,
+    stale: z.boolean().default(false),
+    manual_overlay: SoilManualOverlaySchema.default({ enabled: false, status: "candidate" }),
+    goal_id: z.string().min(1).optional(),
+    task_id: z.string().min(1).optional(),
+    schedule_id: z.string().min(1).optional(),
+    decision_id: z.string().min(1).optional(),
+    entry_id: z.string().min(1).optional(),
+    domain: z.string().min(1).optional(),
+    confidence: z.number().min(0).max(1).optional(),
+    priority: z.number().int().optional(),
+    summary: z.string().optional(),
+    owner: z.string().min(1).optional(),
+    source_truth: SoilSourceTruthSchema.optional(),
+    rendered_from: z.string().min(1).optional(),
+    import_status: SoilImportStatusSchema.default("none"),
+    approval_status: SoilApprovalStatusSchema.default("none"),
+    approved_at: datetimeSchema.optional(),
+    approved_by: z.string().min(1).optional(),
+    supersedes: z.array(z.string().min(1)).default([]),
+    superseded_by: z.string().min(1).optional(),
+    checksum: z.string().min(1).optional(),
+    page_format_version: z.string().min(1).optional(),
+})
+    .passthrough();
+export function isSoilDatetime(value) {
+    return !Number.isNaN(Date.parse(value));
+}
+//# sourceMappingURL=types.js.map

package/dist/platform/soil/types.js.map

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

package/dist/platform/time/effect-latency-estimator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Heuristic categorization of action types to expected effect latency.
+ * Used to auto-suggest wait_until durations for WaitStrategy.
+ */
+export interface EffectLatencyEstimate {
+    actionType: string;
+    estimatedHours: number;
+    confidence: "high" | "low";
+    suggestedWaitUntil: string;
+}
+export declare function estimateEffectLatency(actionType: string, startTime?: string): EffectLatencyEstimate;
+/** Register custom latency for an action type (for plugins/extensions). */
+export declare function registerLatencyDefault(actionType: string, hours: number): void;
+export declare function resetLatencyDefaults(): void;
+//# sourceMappingURL=effect-latency-estimator.d.ts.map

package/dist/platform/time/effect-latency-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-latency-estimator.d.ts","sourceRoot":"","sources":["../../../src/platform/time/effect-latency-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,qBAAqB,CAcvB;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9E;AAKD,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/platform/time/effect-latency-estimator.js

@@ -0,0 +1,39 @@
+/**
+ * Heuristic categorization of action types to expected effect latency.
+ * Used to auto-suggest wait_until durations for WaitStrategy.
+ */
+// Map task categories to expected effect duration in hours
+const LATENCY_DEFAULTS = {
+    deploy: 1, // deployments take ~1 hour to show effects
+    marketing: 72, // marketing campaigns need ~3 days
+    documentation: 24, // docs take ~1 day to impact metrics
+    training: 48, // model training effects visible in ~2 days
+    infrastructure: 4, // infra changes show effects in ~4 hours
+    default: 12, // conservative default: 12 hours
+};
+export function estimateEffectLatency(actionType, startTime) {
+    const normalizedType = actionType.toLowerCase().trim();
+    const hours = LATENCY_DEFAULTS[normalizedType] ?? LATENCY_DEFAULTS["default"];
+    const confidence = normalizedType in LATENCY_DEFAULTS ? "high" : "low";
+    const start = startTime ? new Date(startTime) : new Date();
+    const waitUntil = new Date(start.getTime() + hours * 60 * 60 * 1000);
+    return {
+        actionType: normalizedType,
+        estimatedHours: hours,
+        confidence,
+        suggestedWaitUntil: waitUntil.toISOString(),
+    };
+}
+/** Register custom latency for an action type (for plugins/extensions). */
+export function registerLatencyDefault(actionType, hours) {
+    LATENCY_DEFAULTS[actionType.toLowerCase().trim()] = hours;
+}
+/** Reset LATENCY_DEFAULTS to the original built-in values. Used in tests for isolation. */
+const ORIGINAL_LATENCY_DEFAULTS = { ...LATENCY_DEFAULTS };
+export function resetLatencyDefaults() {
+    for (const key of Object.keys(LATENCY_DEFAULTS)) {
+        delete LATENCY_DEFAULTS[key];
+    }
+    Object.assign(LATENCY_DEFAULTS, ORIGINAL_LATENCY_DEFAULTS);
+}
+//# sourceMappingURL=effect-latency-estimator.js.map

package/dist/platform/time/effect-latency-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-latency-estimator.js","sourceRoot":"","sources":["../../../src/platform/time/effect-latency-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,MAAM,gBAAgB,GAA2B;IAC/C,MAAM,EAAE,CAAC,EAAW,2CAA2C;IAC/D,SAAS,EAAE,EAAE,EAAO,mCAAmC;IACvD,aAAa,EAAE,EAAE,EAAG,qCAAqC;IACzD,QAAQ,EAAE,EAAE,EAAQ,4CAA4C;IAChE,cAAc,EAAE,CAAC,EAAG,yCAAyC;IAC7D,OAAO,EAAE,EAAE,EAAS,iCAAiC;CACtD,CAAC;AASF,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,SAAkB;IAElB,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,gBAAgB,CAAC,cAAc,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,cAAc,IAAI,gBAAgB,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC,CAAC,KAAc,CAAC;IAEzF,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAErE,OAAO;QACL,UAAU,EAAE,cAAc;QAC1B,cAAc,EAAE,KAAK;QACrB,UAAU;QACV,kBAAkB,EAAE,SAAS,CAAC,WAAW,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,KAAa;IACtE,gBAAgB,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;AAC5D,CAAC;AAED,2FAA2F;AAC3F,MAAM,yBAAyB,GAA2B,EAAE,GAAG,gBAAgB,EAAE,CAAC;AAElF,MAAM,UAAU,oBAAoB;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,yBAAyB,CAAC,CAAC;AAC7D,CAAC"}

package/dist/platform/time/time-horizon-engine.d.ts

@@ -0,0 +1,18 @@
+import type { GapObservation, PacingResult, CompletionProjection, TimeBudgetWithWait, TimeHorizonConfig } from "../../base/types/time-horizon.js";
+export interface ITimeHorizonEngine {
+    evaluatePacing(goalId: string, currentGap: number, deadline: string | null, history: GapObservation[]): PacingResult;
+    projectCompletion(velocity: number, velocityStddev: number, remainingGap: number): CompletionProjection;
+    suggestObservationInterval(pacingResult: PacingResult, baseIntervalMs: number): number;
+    getTimeBudget(deadline: string | null, startTime: string, currentGap: number, initialGap: number, velocityPerHour: number): TimeBudgetWithWait;
+}
+export declare class TimeHorizonEngine implements ITimeHorizonEngine {
+    private readonly config;
+    constructor(config?: Partial<TimeHorizonConfig>);
+    evaluatePacing(_goalId: string, currentGap: number, deadline: string | null, history: GapObservation[]): PacingResult;
+    projectCompletion(velocity: number, velocityStddev: number, remainingGap: number): CompletionProjection;
+    suggestObservationInterval(pacingResult: PacingResult, baseIntervalMs: number): number;
+    getTimeBudget(deadline: string | null, startTime: string, currentGap: number, initialGap: number, velocityPerHour: number): TimeBudgetWithWait;
+    private classifyStatus;
+    private isVelocityDeclining;
+}
+//# sourceMappingURL=time-horizon-engine.d.ts.map

package/dist/platform/time/time-horizon-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-horizon-engine.d.ts","sourceRoot":"","sources":["../../../src/platform/time/time-horizon-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAGZ,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAK1C,MAAM,WAAW,kBAAkB;IACjC,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,cAAc,EAAE,GACxB,YAAY,CAAC;IAEhB,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,oBAAoB,CAAC;IAExB,0BAA0B,CACxB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC;IAEV,aAAa,CACX,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,kBAAkB,CAAC;CACvB;AAsED,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI/C,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,cAAc,EAAE,GACxB,YAAY;IAqDf,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,oBAAoB;IA8BvB,0BAA0B,CAAC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IA0BtF,aAAa,CACX,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,kBAAkB;IA6CrB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,mBAAmB;CAc5B"}

package/dist/platform/time/time-horizon-engine.js

@@ -0,0 +1,215 @@
+import { TimeHorizonConfigSchema } from "../../base/types/time-horizon.js";
+const EPSILON = 1e-9;
+// ─── Velocity helpers ─────────────────────────────────────────────────────────
+function calcPointVelocities(history, windowSize) {
+    const window = history.slice(-windowSize - 1);
+    const velocities = [];
+    for (let i = 1; i < window.length; i++) {
+        const prev = window[i - 1];
+        const curr = window[i];
+        const hoursElapsed = (new Date(curr.timestamp).getTime() - new Date(prev.timestamp).getTime()) /
+            3_600_000;
+        if (hoursElapsed <= 0)
+            continue;
+        velocities.push((prev.normalizedGap - curr.normalizedGap) / hoursElapsed);
+    }
+    return velocities;
+}
+function calcEmaVelocity(pointVelocities, alpha) {
+    if (pointVelocities.length === 0)
+        return 0;
+    let ema = pointVelocities[0];
+    for (let i = 1; i < pointVelocities.length; i++) {
+        ema = alpha * pointVelocities[i] + (1 - alpha) * ema;
+    }
+    return ema;
+}
+function calcStddev(values) {
+    if (values.length < 2)
+        return 0;
+    const mean = values.reduce((a, b) => a + b, 0) / values.length;
+    const variance = values.reduce((sum, v) => sum + (v - mean) ** 2, 0) / values.length;
+    return Math.sqrt(variance);
+}
+function hoursFromNow(isoDate) {
+    return (new Date(isoDate).getTime() - Date.now()) / 3_600_000;
+}
+function addHoursToNow(hours) {
+    return new Date(Date.now() + hours * 3_600_000).toISOString();
+}
+// ─── Recommendation mapping ───────────────────────────────────────────────────
+function deriveRecommendation(status, confidence, isVelocityDeclining) {
+    switch (status) {
+        case "ahead":
+        case "on_track":
+            return "maintain_course";
+        case "behind":
+            return confidence >= 0.6 ? "consider_strategy_change" : "increase_effort";
+        case "critical":
+            return confidence >= 0.6 ? "escalate_to_user" : "consider_strategy_change";
+        case "no_deadline":
+            return isVelocityDeclining
+                ? "sustainable_pace_declining"
+                : "sustainable_pace_ok";
+    }
+}
+// ─── TimeHorizonEngine ────────────────────────────────────────────────────────
+export class TimeHorizonEngine {
+    config;
+    constructor(config) {
+        this.config = TimeHorizonConfigSchema.parse(config ?? {});
+    }
+    evaluatePacing(_goalId, currentGap, deadline, history) {
+        const { velocity_window_size, velocity_ema_alpha, min_observations_for_projection } = this.config;
+        const pointVelocities = calcPointVelocities(history, velocity_window_size);
+        const velocityPerHour = calcEmaVelocity(pointVelocities, velocity_ema_alpha);
+        const velocityStddev = calcStddev(pointVelocities);
+        const observationCount = history.length;
+        const confidence = Math.min(1.0, observationCount / min_observations_for_projection);
+        // No deadline — perpetual goal
+        if (deadline === null) {
+            const isVelocityDeclining = this.isVelocityDeclining(history);
+            const recommendation = deriveRecommendation("no_deadline", confidence, isVelocityDeclining);
+            return {
+                status: "no_deadline",
+                velocityPerHour,
+                velocityStddev,
+                projectedCompletionDate: null, // §6.2: no burn-down projection for perpetual goals
+                timeRemainingHours: null,
+                pacingRatio: null,
+                confidence,
+                recommendation,
+            };
+        }
+        const timeRemainingHours = hoursFromNow(deadline);
+        const requiredVelocity = timeRemainingHours > 0 ? currentGap / timeRemainingHours : Infinity;
+        const effectiveVelocity = Math.max(velocityPerHour, EPSILON);
+        const pacingRatio = requiredVelocity / effectiveVelocity;
+        const status = this.classifyStatus(pacingRatio);
+        const recommendation = deriveRecommendation(status, confidence, false);
+        const projection = observationCount >= min_observations_for_projection && velocityPerHour > 0
+            ? this.projectCompletion(velocityPerHour, velocityStddev, currentGap)
+            : null;
+        return {
+            status,
+            velocityPerHour,
+            velocityStddev,
+            projectedCompletionDate: projection?.estimatedDate ?? null,
+            timeRemainingHours,
+            pacingRatio,
+            confidence,
+            recommendation,
+        };
+    }
+    projectCompletion(velocity, velocityStddev, remainingGap) {
+        if (velocity <= 0) {
+            return {
+                estimatedDate: null,
+                confidenceInterval: null,
+                isAchievable: false,
+            };
+        }
+        const hoursRemaining = remainingGap / velocity;
+        const estimatedDate = addHoursToNow(hoursRemaining);
+        const optimisticVelocity = velocity + velocityStddev;
+        const pessimisticVelocity = Math.max(velocity - velocityStddev, EPSILON);
+        const optimisticHours = remainingGap / optimisticVelocity;
+        const pessimisticHours = remainingGap / pessimisticVelocity;
+        const confidenceInterval = {
+            optimistic: addHoursToNow(optimisticHours),
+            pessimistic: addHoursToNow(pessimisticHours),
+        };
+        // isAchievable is always true when there is no deadline to compare against;
+        // callers that have a deadline should compare pessimistic date themselves.
+        const isAchievable = true;
+        return { estimatedDate, confidenceInterval, isAchievable };
+    }
+    suggestObservationInterval(pacingResult, baseIntervalMs) {
+        const { observation_interval_multipliers } = this.config;
+        const status = pacingResult.status;
+        let multiplier;
+        switch (status) {
+            case "critical":
+                multiplier = observation_interval_multipliers.critical;
+                break;
+            case "behind":
+                multiplier = observation_interval_multipliers.behind;
+                break;
+            case "on_track":
+                multiplier = observation_interval_multipliers.on_track;
+                break;
+            case "ahead":
+                multiplier = observation_interval_multipliers.ahead;
+                break;
+            case "no_deadline":
+                multiplier = observation_interval_multipliers.no_deadline;
+                break;
+            default:
+                multiplier = 1.0;
+        }
+        return baseIntervalMs * multiplier;
+    }
+    getTimeBudget(deadline, startTime, currentGap, initialGap, velocityPerHour) {
+        const now = Date.now();
+        const startMs = new Date(startTime).getTime();
+        const elapsedHours = (now - startMs) / 3_600_000;
+        let totalHours = null;
+        let remainingHours = null;
+        let percentElapsed = null;
+        if (deadline !== null) {
+            const deadlineMs = new Date(deadline).getTime();
+            totalHours = (deadlineMs - startMs) / 3_600_000;
+            remainingHours = (deadlineMs - now) / 3_600_000;
+            percentElapsed = totalHours > 0 ? elapsedHours / totalHours : null;
+        }
+        const percentGapRemaining = initialGap > 0 ? currentGap / initialGap : 0;
+        const criticalThreshold = this.config.pacing_thresholds.critical;
+        const capturedRemainingHours = remainingHours;
+        const capturedVelocity = velocityPerHour;
+        const capturedCurrentGap = currentGap;
+        const canAffordWait = (waitHours) => {
+            if (capturedVelocity <= 0)
+                return false;
+            if (capturedRemainingHours === null)
+                return true; // no deadline, can always wait
+            const newRemainingHours = capturedRemainingHours - waitHours;
+            if (newRemainingHours <= 0)
+                return false;
+            const newRequiredVelocity = capturedCurrentGap / newRemainingHours;
+            const newPacingRatio = newRequiredVelocity / Math.max(capturedVelocity, EPSILON);
+            return newPacingRatio <= criticalThreshold;
+        };
+        return {
+            totalHours,
+            elapsedHours,
+            remainingHours,
+            percentElapsed,
+            percentGapRemaining,
+            canAffordWait,
+        };
+    }
+    // ─── Private helpers ──────────────────────────────────────────────────────
+    classifyStatus(pacingRatio) {
+        const { ahead, behind, critical } = this.config.pacing_thresholds;
+        if (pacingRatio < ahead)
+            return "ahead";
+        if (pacingRatio < behind)
+            return "on_track";
+        if (pacingRatio < critical)
+            return "behind";
+        return "critical";
+    }
+    isVelocityDeclining(history) {
+        const { velocity_window_size, velocity_ema_alpha, sustainable_pace_decline_threshold } = this.config;
+        if (history.length < 2)
+            return false;
+        const allVelocities = calcPointVelocities(history, history.length);
+        const recentVelocities = calcPointVelocities(history, velocity_window_size);
+        const historicalEma = calcEmaVelocity(allVelocities, velocity_ema_alpha);
+        const recentEma = calcEmaVelocity(recentVelocities, velocity_ema_alpha);
+        if (historicalEma <= 0)
+            return true; // no positive historical velocity is itself a decline
+        return recentEma < historicalEma * (1 - sustainable_pace_decline_threshold);
+    }
+}
+//# sourceMappingURL=time-horizon-engine.js.map

package/dist/platform/time/time-horizon-engine.js.map

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

package/dist/platform/tools/executor.d.ts

@@ -0,0 +1,2 @@
+export * from "../../tools/executor.js";
+//# sourceMappingURL=executor.d.ts.map

package/dist/platform/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/platform/tools/executor.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/platform/tools/executor.js

@@ -0,0 +1,2 @@
+export * from "../../tools/executor.js";
+//# sourceMappingURL=executor.js.map

package/dist/platform/tools/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/platform/tools/executor.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/platform/traits/character-config.d.ts

@@ -0,0 +1,34 @@
+import type { CharacterConfig } from "../../base/types/character.js";
+import type { StateManager } from "../../base/state/state-manager.js";
+/**
+ * CharacterConfigManager handles persistence of character configuration.
+ *
+ * File layout:
+ *   <base>/character-config.json
+ *
+ * Uses StateManager.readRaw / writeRaw for filesystem access (DI pattern).
+ */
+export declare class CharacterConfigManager {
+    private readonly stateManager;
+    constructor(stateManager: StateManager);
+    /**
+     * Loads character config from disk.
+     * Returns DEFAULT_CHARACTER_CONFIG when no file exists.
+     * Validates the stored data with Zod before returning.
+     */
+    load(): Promise<CharacterConfig>;
+    /**
+     * Validates config with Zod and writes it to disk atomically.
+     */
+    save(config: CharacterConfig): Promise<void>;
+    /**
+     * Resets config to DEFAULT_CHARACTER_CONFIG and persists it.
+     */
+    reset(): Promise<void>;
+    /**
+     * Merges partial values into the current config, saves the result,
+     * and returns the updated config.
+     */
+    update(partial: Partial<CharacterConfig>): Promise<CharacterConfig>;
+}
+//# sourceMappingURL=character-config.d.ts.map

package/dist/platform/traits/character-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-config.d.ts","sourceRoot":"","sources":["../../../src/platform/traits/character-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,YAAY,EAAE,YAAY;IAItC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAQtC;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAO1E"}

package/dist/platform/traits/character-config.js

@@ -0,0 +1,53 @@
+import { CharacterConfigSchema, DEFAULT_CHARACTER_CONFIG } from "../../base/types/character.js";
+const CHARACTER_CONFIG_PATH = "character-config.json";
+/**
+ * CharacterConfigManager handles persistence of character configuration.
+ *
+ * File layout:
+ *   <base>/character-config.json
+ *
+ * Uses StateManager.readRaw / writeRaw for filesystem access (DI pattern).
+ */
+export class CharacterConfigManager {
+    stateManager;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    /**
+     * Loads character config from disk.
+     * Returns DEFAULT_CHARACTER_CONFIG when no file exists.
+     * Validates the stored data with Zod before returning.
+     */
+    async load() {
+        const raw = await this.stateManager.readRaw(CHARACTER_CONFIG_PATH);
+        if (raw === null) {
+            return DEFAULT_CHARACTER_CONFIG;
+        }
+        return CharacterConfigSchema.parse(raw);
+    }
+    /**
+     * Validates config with Zod and writes it to disk atomically.
+     */
+    async save(config) {
+        const parsed = CharacterConfigSchema.parse(config);
+        await this.stateManager.writeRaw(CHARACTER_CONFIG_PATH, parsed);
+    }
+    /**
+     * Resets config to DEFAULT_CHARACTER_CONFIG and persists it.
+     */
+    async reset() {
+        await this.save(DEFAULT_CHARACTER_CONFIG);
+    }
+    /**
+     * Merges partial values into the current config, saves the result,
+     * and returns the updated config.
+     */
+    async update(partial) {
+        const current = await this.load();
+        const merged = { ...current, ...partial };
+        const validated = CharacterConfigSchema.parse(merged);
+        await this.save(validated);
+        return validated;
+    }
+}
+//# sourceMappingURL=character-config.js.map

package/dist/platform/traits/character-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character-config.js","sourceRoot":"","sources":["../../../src/platform/traits/character-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAIhG,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAChB,YAAY,CAAe;IAE5C,YAAY,YAA0B;QACpC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACnE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,wBAAwB,CAAC;QAClC,CAAC;QACD,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAuB;QAChC,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,OAAiC;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}