pulseed 0.0.1 → 0.1.0

package/dist/types/goal.d.ts.map

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

package/dist/types/goal.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+import { ThresholdSchema, ObservationMethodSchema, AggregationTypeEnum, GapAggregationEnum, PaceStatusEnum, } from "./core.js";
+// --- History Entry ---
+export const HistoryEntrySchema = z.object({
+    value: z.union([z.number(), z.string(), z.boolean(), z.null()]),
+    timestamp: z.string(),
+    confidence: z.number().min(0).max(1),
+    source_observation_id: z.string(),
+});
+// --- Satisficing Aggregation Enum (distinct from gap calculation aggregation) ---
+/**
+ * SatisficingAggregation defines how multiple subgoal dimensions aggregate
+ * into a parent goal dimension during completion propagation.
+ *
+ * Note: This is distinct from AggregationTypeEnum (gap calculation) which includes "weighted_avg".
+ * Satisficing uses simple aggregation strategies: min, avg, max, all_required.
+ */
+export const SatisficingAggregationEnum = z.enum(["min", "avg", "max", "all_required"]);
+// --- Dimension ---
+export const DimensionSchema = z.object({
+    name: z.string(),
+    label: z.string(),
+    current_value: z.union([z.number(), z.string(), z.boolean(), z.null()]),
+    threshold: ThresholdSchema,
+    confidence: z.number().min(0).max(1),
+    observation_method: ObservationMethodSchema,
+    last_updated: z.string().nullable(),
+    history: z.array(HistoryEntrySchema),
+    /** Weight for gap aggregation (default 1.0) */
+    weight: z.number().default(1.0),
+    /** Per-dimension uncertainty_weight override (null = use global) */
+    uncertainty_weight: z.number().nullable().default(null),
+    /**
+     * Integrity flag: set to "uncertain" when a revert fails so PulSeed stops
+     * autonomous task selection for this dimension until a human resets it.
+     * See task-lifecycle.md §6.
+     */
+    state_integrity: z.enum(["ok", "uncertain"]).default("ok"),
+    /**
+     * The observation layer that last updated this dimension's confidence.
+     * Used to compare against incoming observation priority (replaces static
+     * confidence_tier comparison which never changes after goal creation).
+     */
+    last_observed_layer: z
+        .enum(["self_report", "independent_review", "mechanical"])
+        .optional(),
+    /**
+     * Maps this subgoal dimension to a parent goal dimension with an aggregation strategy.
+     * When set, propagateSubgoalCompletion uses parent_dimension (not name matching)
+     * and aggregates multiple subgoal dimensions mapped to the same parent dimension.
+     * See satisficing.md §7 Phase 2.
+     */
+    dimension_mapping: z
+        .object({
+        parent_dimension: z.string(),
+        aggregation: SatisficingAggregationEnum,
+    })
+        .nullable()
+        .default(null),
+});
+// --- Dimension Mapping (for sub-goal to parent propagation) ---
+export const DimensionMappingSchema = z.object({
+    parent_dimension: z.string(),
+    aggregation: AggregationTypeEnum,
+});
+// --- Milestone Pace Snapshot ---
+export const PaceSnapshotSchema = z.object({
+    elapsed_ratio: z.number(),
+    achievement_ratio: z.number(),
+    pace_ratio: z.number(),
+    status: PaceStatusEnum,
+    evaluated_at: z.string(),
+});
+// --- Goal Node Type ---
+export const GoalNodeTypeEnum = z.enum(["goal", "subgoal", "milestone", "leaf"]);
+// --- Goal Status ---
+export const GoalStatusEnum = z.enum([
+    "active",
+    "completed",
+    "cancelled",
+    "waiting",
+    "archived",
+    "abandoned",
+]);
+// --- Observation Optimization ---
+export const ObservationOptimizationSchema = z.object({
+    /** Minimum seconds between LLM observations for a dimension (default: 60) */
+    min_observation_interval_sec: z.number().int().min(0).default(60),
+    /** Skip LLM observation when pre-check detects no change (default: true) */
+    skip_on_no_change: z.boolean().default(true),
+    /** Pre-check strategies to use before LLM observation */
+    pre_check_strategies: z
+        .array(z.enum(["datasource_delta", "file_stat", "git_diff", "age"]))
+        .default(["datasource_delta", "git_diff", "age"]),
+});
+// --- Goal (a node in the goal tree) ---
+export const GoalSchema = z.object({
+    id: z.string(),
+    parent_id: z.string().nullable().default(null),
+    node_type: GoalNodeTypeEnum.default("goal"),
+    title: z.string(),
+    description: z.string().default(""),
+    status: GoalStatusEnum.default("active"),
+    dimensions: z.array(DimensionSchema),
+    /** Aggregation method for child goals (default: max = bottleneck) */
+    gap_aggregation: GapAggregationEnum.default("max"),
+    /** Dimension mapping for sub-goal to parent propagation */
+    dimension_mapping: DimensionMappingSchema.nullable().default(null),
+    constraints: z.array(z.string()).default([]),
+    children_ids: z.array(z.string()).default([]),
+    // Milestone-specific fields
+    target_date: z.string().nullable().default(null),
+    origin: z
+        .enum(["negotiation", "decomposition", "manual", "curiosity"])
+        .nullable()
+        .default(null),
+    pace_snapshot: PaceSnapshotSchema.nullable().default(null),
+    // Deadline & scheduling
+    deadline: z.string().nullable().default(null),
+    // Negotiation metadata
+    confidence_flag: z.enum(["high", "medium", "low"]).nullable().default(null),
+    user_override: z.boolean().default(false),
+    feasibility_note: z.string().nullable().default(null),
+    // Global uncertainty_weight for gap calculation (default: 1.0)
+    uncertainty_weight: z.number().default(1.0),
+    // Stage 14: Goal tree decomposition fields
+    decomposition_depth: z.number().int().min(0).default(0),
+    specificity_score: z.number().min(0).max(1).nullable().default(null),
+    loop_status: z.enum(["idle", "running", "paused"]).default("idle"),
+    // Token optimization: staged observation config (optional)
+    observation_optimization: ObservationOptimizationSchema.optional(),
+    // Timing
+    created_at: z.string(),
+    updated_at: z.string(),
+});
+// --- Goal Tree (collection of goals for a top-level goal) ---
+export const GoalTreeSchema = z.object({
+    root_id: z.string(),
+    goals: z.record(z.string(), GoalSchema),
+});
+//# sourceMappingURL=goal.js.map

package/dist/types/goal.js.map

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

package/dist/types/guardrail.d.ts

@@ -0,0 +1,104 @@
+import { z } from "zod";
+export declare const GuardrailCheckpointEnum: z.ZodEnum<["before_model", "after_model", "before_tool", "after_tool"]>;
+export type GuardrailCheckpoint = z.infer<typeof GuardrailCheckpointEnum>;
+export declare const GuardrailSeverityEnum: z.ZodEnum<["info", "warning", "critical"]>;
+export type GuardrailSeverity = z.infer<typeof GuardrailSeverityEnum>;
+export declare const GuardrailResultSchema: z.ZodObject<{
+    hook_name: z.ZodString;
+    checkpoint: z.ZodEnum<["before_model", "after_model", "before_tool", "after_tool"]>;
+    allowed: z.ZodBoolean;
+    severity: z.ZodDefault<z.ZodEnum<["info", "warning", "critical"]>>;
+    reason: z.ZodOptional<z.ZodString>;
+    modified_input: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    hook_name: string;
+    checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+    allowed: boolean;
+    severity: "info" | "warning" | "critical";
+    reason?: string | undefined;
+    modified_input?: unknown;
+}, {
+    hook_name: string;
+    checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+    allowed: boolean;
+    severity?: "info" | "warning" | "critical" | undefined;
+    reason?: string | undefined;
+    modified_input?: unknown;
+}>;
+export type GuardrailResult = z.infer<typeof GuardrailResultSchema>;
+export declare const GuardrailAggregateResultSchema: z.ZodObject<{
+    allowed: z.ZodBoolean;
+    results: z.ZodArray<z.ZodObject<{
+        hook_name: z.ZodString;
+        checkpoint: z.ZodEnum<["before_model", "after_model", "before_tool", "after_tool"]>;
+        allowed: z.ZodBoolean;
+        severity: z.ZodDefault<z.ZodEnum<["info", "warning", "critical"]>>;
+        reason: z.ZodOptional<z.ZodString>;
+        modified_input: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        hook_name: string;
+        checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+        allowed: boolean;
+        severity: "info" | "warning" | "critical";
+        reason?: string | undefined;
+        modified_input?: unknown;
+    }, {
+        hook_name: string;
+        checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+        allowed: boolean;
+        severity?: "info" | "warning" | "critical" | undefined;
+        reason?: string | undefined;
+        modified_input?: unknown;
+    }>, "many">;
+    modified_input: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    allowed: boolean;
+    results: {
+        hook_name: string;
+        checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+        allowed: boolean;
+        severity: "info" | "warning" | "critical";
+        reason?: string | undefined;
+        modified_input?: unknown;
+    }[];
+    modified_input?: unknown;
+}, {
+    allowed: boolean;
+    results: {
+        hook_name: string;
+        checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+        allowed: boolean;
+        severity?: "info" | "warning" | "critical" | undefined;
+        reason?: string | undefined;
+        modified_input?: unknown;
+    }[];
+    modified_input?: unknown;
+}>;
+export type GuardrailAggregateResult = z.infer<typeof GuardrailAggregateResultSchema>;
+export declare const GuardrailContextSchema: z.ZodObject<{
+    checkpoint: z.ZodEnum<["before_model", "after_model", "before_tool", "after_tool"]>;
+    goal_id: z.ZodOptional<z.ZodString>;
+    task_id: z.ZodOptional<z.ZodString>;
+    input: z.ZodUnknown;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+    goal_id?: string | undefined;
+    task_id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    input?: unknown;
+}, {
+    checkpoint: "before_model" | "after_model" | "before_tool" | "after_tool";
+    goal_id?: string | undefined;
+    task_id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    input?: unknown;
+}>;
+export type GuardrailContext = z.infer<typeof GuardrailContextSchema>;
+export interface IGuardrailHook {
+    readonly name: string;
+    readonly checkpoint: GuardrailCheckpoint;
+    readonly priority: number;
+    execute(context: GuardrailContext): Promise<GuardrailResult>;
+}
+//# sourceMappingURL=guardrail.d.ts.map

package/dist/types/guardrail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail.d.ts","sourceRoot":"","sources":["../../src/types/guardrail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB,yEAKlC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAG1E,eAAO,MAAM,qBAAqB,4CAA0C,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGtE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAGtF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9D"}

package/dist/types/guardrail.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+// 4 checkpoint types where guardrails execute
+export const GuardrailCheckpointEnum = z.enum([
+    "before_model",
+    "after_model",
+    "before_tool",
+    "after_tool",
+]);
+// Severity levels for guardrail results
+export const GuardrailSeverityEnum = z.enum(["info", "warning", "critical"]);
+// Result of a guardrail check
+export const GuardrailResultSchema = z.object({
+    hook_name: z.string(),
+    checkpoint: GuardrailCheckpointEnum,
+    allowed: z.boolean(),
+    severity: GuardrailSeverityEnum.default("info"),
+    reason: z.string().optional(),
+    modified_input: z.unknown().optional(),
+});
+// Aggregate result from running all hooks at a checkpoint
+export const GuardrailAggregateResultSchema = z.object({
+    allowed: z.boolean(),
+    results: z.array(GuardrailResultSchema),
+    modified_input: z.unknown().optional(),
+});
+// Context passed to guardrail hooks
+export const GuardrailContextSchema = z.object({
+    checkpoint: GuardrailCheckpointEnum,
+    goal_id: z.string().optional(),
+    task_id: z.string().optional(),
+    input: z.unknown(), // prompt string, task object, or result object depending on checkpoint
+    metadata: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=guardrail.js.map

package/dist/types/guardrail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail.js","sourceRoot":"","sources":["../../src/types/guardrail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8CAA8C;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC5C,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AAGH,wCAAwC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAG7E,8BAA8B;AAC9B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,uBAAuB;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAGH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACvC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAGH,oCAAoC;AACpC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,uBAAuB;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,uEAAuE;IAC3F,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,32 @@
+export * from "./core.js";
+export * from "./goal.js";
+export * from "./state.js";
+export * from "./gap.js";
+export * from "./task.js";
+export * from "./trust.js";
+export * from "./session.js";
+export * from "./strategy.js";
+export * from "./drive.js";
+export * from "./report.js";
+export * from "./stall.js";
+export * from "./satisficing.js";
+export * from "./ethics.js";
+export * from "./negotiation.js";
+export * from "./knowledge.js";
+export * from "./capability.js";
+export * from "./portfolio.js";
+export * from "./daemon.js";
+export * from "./notification.js";
+export * from "./memory-lifecycle.js";
+export * from "./dependency.js";
+export * from "./data-source.js";
+export * from "./goal-tree.js";
+export * from "./cross-portfolio.js";
+export * from "./learning.js";
+export * from "./suggest.js";
+export * from "./plugin.js";
+export * from "./pipeline.js";
+export * from "./task-group.js";
+export * from "./reflection.js";
+export * from "./goal-refiner.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,32 @@
+export * from "./core.js";
+export * from "./goal.js";
+export * from "./state.js";
+export * from "./gap.js";
+export * from "./task.js";
+export * from "./trust.js";
+export * from "./session.js";
+export * from "./strategy.js";
+export * from "./drive.js";
+export * from "./report.js";
+export * from "./stall.js";
+export * from "./satisficing.js";
+export * from "./ethics.js";
+export * from "./negotiation.js";
+export * from "./knowledge.js";
+export * from "./capability.js";
+export * from "./portfolio.js";
+export * from "./daemon.js";
+export * from "./notification.js";
+export * from "./memory-lifecycle.js";
+export * from "./dependency.js";
+export * from "./data-source.js";
+export * from "./goal-tree.js";
+export * from "./cross-portfolio.js";
+export * from "./learning.js";
+export * from "./suggest.js";
+export * from "./plugin.js";
+export * from "./pipeline.js";
+export * from "./task-group.js";
+export * from "./reflection.js";
+export * from "./goal-refiner.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}