@a5c-ai/genty-platform 5.1.1-staging.583e3d9a6ed7

package/dist/harness/planMode.d.ts

@@ -0,0 +1,68 @@
+/**
+ * GAP-USER-012: Plan Mode with Verification
+ *
+ * Interactive plan-verify-execute loop. Generates structured plans,
+ * presents for approval, executes with per-step verification,
+ * and allows plan modification mid-execution.
+ */
+/** A single step in an execution plan. */
+export interface PlanStep {
+    /** Unique step identifier. */
+    id: string;
+    /** Human-readable title. */
+    title: string;
+    /** Description of what this step does. */
+    description: string;
+    /** Step status. */
+    status: PlanStepStatus;
+    /** Dependencies (IDs of steps that must complete first). */
+    dependsOn: string[];
+    /** Verification criteria for this step. */
+    verificationCriteria?: string;
+    /** Task ID if this step was dispatched as an effect. */
+    effectId?: string;
+    /** Timestamp of completion. */
+    completedAt?: string;
+    /** Feedback received during verification. */
+    feedback?: string;
+}
+export type PlanStepStatus = "pending" | "in_progress" | "completed" | "failed" | "skipped" | "modified";
+/** An execution plan. */
+export interface ExecutionPlan {
+    /** Plan ID. */
+    id: string;
+    /** Plan title. */
+    title: string;
+    /** Overall goal/description. */
+    description: string;
+    /** Ordered steps. */
+    steps: PlanStep[];
+    /** Plan status. */
+    status: PlanStatus;
+    /** Creation timestamp. */
+    createdAt: string;
+    /** Last update timestamp. */
+    updatedAt: string;
+}
+export type PlanStatus = "draft" | "approved" | "executing" | "completed" | "failed" | "modified";
+/** Create a new execution plan. */
+export declare function createPlan(id: string, title: string, description: string, steps: Array<Omit<PlanStep, "status">>): ExecutionPlan;
+/** Update a step's status. */
+export declare function updateStepStatus(plan: ExecutionPlan, stepId: string, status: PlanStepStatus, feedback?: string): ExecutionPlan;
+/** Insert a new step into the plan at a given position. */
+export declare function insertStep(plan: ExecutionPlan, step: Omit<PlanStep, "status">, afterStepId?: string): ExecutionPlan;
+/** Remove a step from the plan. Also removes it from other steps' dependsOn lists. */
+export declare function removeStep(plan: ExecutionPlan, stepId: string): ExecutionPlan;
+/** Get the next executable step (all dependencies satisfied). */
+export declare function getNextStep(plan: ExecutionPlan): PlanStep | undefined;
+/** Get plan progress summary. */
+export declare function getPlanProgress(plan: ExecutionPlan): {
+    total: number;
+    completed: number;
+    failed: number;
+    pending: number;
+    percentComplete: number;
+};
+/** Format plan for display. */
+export declare function formatPlanForDisplay(plan: ExecutionPlan): string;
+//# sourceMappingURL=planMode.d.ts.map

package/dist/harness/planMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planMode.d.ts","sourceRoot":"","sources":["../../src/harness/planMode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,0CAA0C;AAC1C,MAAM,WAAW,QAAQ;IACvB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzG,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,mBAAmB;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMlG,mCAAmC;AACnC,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GACrC,aAAa,CAWf;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,aAAa,CAuBf;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC9B,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,CAiBf;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAc7E;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS,CAWrE;AAED,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAYA;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA2BhE"}

package/dist/harness/planMode.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * GAP-USER-012: Plan Mode with Verification
+ *
+ * Interactive plan-verify-execute loop. Generates structured plans,
+ * presents for approval, executes with per-step verification,
+ * and allows plan modification mid-execution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPlan = createPlan;
+exports.updateStepStatus = updateStepStatus;
+exports.insertStep = insertStep;
+exports.removeStep = removeStep;
+exports.getNextStep = getNextStep;
+exports.getPlanProgress = getPlanProgress;
+exports.formatPlanForDisplay = formatPlanForDisplay;
+// ---------------------------------------------------------------------------
+// Plan construction
+// ---------------------------------------------------------------------------
+/** Create a new execution plan. */
+function createPlan(id, title, description, steps) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        title,
+        description,
+        steps: steps.map((s) => ({ ...s, status: "pending" })),
+        status: "draft",
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Update a step's status. */
+function updateStepStatus(plan, stepId, status, feedback) {
+    const now = new Date().toISOString();
+    const steps = plan.steps.map((s) => {
+        if (s.id !== stepId)
+            return s;
+        return {
+            ...s,
+            status,
+            completedAt: status === "completed" || status === "failed" ? now : s.completedAt,
+            feedback: feedback ?? s.feedback,
+        };
+    });
+    // Derive plan status from step statuses
+    const allCompleted = steps.every((s) => s.status === "completed" || s.status === "skipped");
+    const anyFailed = steps.some((s) => s.status === "failed");
+    const anyInProgress = steps.some((s) => s.status === "in_progress");
+    let planStatus = plan.status;
+    if (allCompleted)
+        planStatus = "completed";
+    else if (anyFailed)
+        planStatus = "failed";
+    else if (anyInProgress)
+        planStatus = "executing";
+    return { ...plan, steps, status: planStatus, updatedAt: now };
+}
+/** Insert a new step into the plan at a given position. */
+function insertStep(plan, step, afterStepId) {
+    const now = new Date().toISOString();
+    const newStep = { ...step, status: "pending" };
+    const steps = [...plan.steps];
+    if (afterStepId) {
+        const idx = steps.findIndex((s) => s.id === afterStepId);
+        if (idx >= 0) {
+            steps.splice(idx + 1, 0, newStep);
+        }
+        else {
+            steps.push(newStep);
+        }
+    }
+    else {
+        steps.push(newStep);
+    }
+    return { ...plan, steps, status: "modified", updatedAt: now };
+}
+/** Remove a step from the plan. Also removes it from other steps' dependsOn lists. */
+function removeStep(plan, stepId) {
+    const now = new Date().toISOString();
+    const steps = plan.steps
+        .filter((s) => s.id !== stepId)
+        .map((s) => ({
+        ...s,
+        dependsOn: s.dependsOn.filter((dep) => dep !== stepId),
+    }));
+    return {
+        ...plan,
+        steps,
+        status: "modified",
+        updatedAt: now,
+    };
+}
+/** Get the next executable step (all dependencies satisfied). */
+function getNextStep(plan) {
+    const completedIds = new Set(plan.steps
+        .filter((s) => s.status === "completed" || s.status === "skipped")
+        .map((s) => s.id));
+    return plan.steps.find((s) => s.status === "pending" &&
+        s.dependsOn.every((dep) => completedIds.has(dep)));
+}
+/** Get plan progress summary. */
+function getPlanProgress(plan) {
+    const total = plan.steps.length;
+    const completed = plan.steps.filter((s) => s.status === "completed" || s.status === "skipped").length;
+    const failed = plan.steps.filter((s) => s.status === "failed").length;
+    const pending = plan.steps.filter((s) => s.status === "pending").length;
+    return {
+        total,
+        completed,
+        failed,
+        pending,
+        percentComplete: total > 0 ? Math.round((completed / total) * 100) : 0,
+    };
+}
+/** Format plan for display. */
+function formatPlanForDisplay(plan) {
+    const progress = getPlanProgress(plan);
+    const lines = [
+        `## ${plan.title}`,
+        `Status: ${plan.status} | Progress: ${progress.completed}/${progress.total} (${progress.percentComplete}%)`,
+        "",
+        plan.description,
+        "",
+        "### Steps",
+    ];
+    for (const step of plan.steps) {
+        const statusIcon = {
+            pending: "[ ]",
+            in_progress: "[~]",
+            completed: "[x]",
+            failed: "[!]",
+            skipped: "[-]",
+            modified: "[*]",
+        }[step.status];
+        lines.push(`${statusIcon} **${step.id}**: ${step.title}`);
+        if (step.description)
+            lines.push(`    ${step.description}`);
+        if (step.dependsOn.length > 0)
+            lines.push(`    Depends on: ${step.dependsOn.join(", ")}`);
+        if (step.feedback)
+            lines.push(`    Feedback: ${step.feedback}`);
+    }
+    return lines.join("\n");
+}

package/dist/harness/selectionPolicies.d.ts

@@ -0,0 +1,29 @@
+/**
+ * GAP-HADAPT-008: Harness Selection Policies.
+ *
+ * Configurable policies for harness selection: cost-optimized,
+ * latency-optimized, capability-first, user-preferred.
+ * Policy evaluator scores candidates using selectHarness from capabilityRouter.
+ */
+import { type TaskRequirements, type HarnessCandidate, type RoutingResult } from "./capabilityRouter";
+export type PolicyName = "cost-optimized" | "latency-optimized" | "capability-first" | "user-preferred";
+export interface SelectionPolicy {
+    name: PolicyName;
+    description: string;
+    evaluate(candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions): PolicyEvaluatorResult;
+}
+export interface PolicyEvaluatorResult {
+    selected: HarnessCandidate | null;
+    policyName: PolicyName;
+    score: number;
+    reason: string;
+    routingResult: RoutingResult | null;
+}
+export interface PolicyEvaluatorOptions {
+    preferredHarness?: string;
+}
+export declare function getDefaultPolicy(): SelectionPolicy;
+export declare function getPolicyByName(name: PolicyName): SelectionPolicy;
+export declare function createPolicyEvaluator(policy: SelectionPolicy): (candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions) => PolicyEvaluatorResult;
+export declare function evaluatePolicy(policyName: PolicyName, candidates: HarnessCandidate[], requirements: Partial<TaskRequirements>, options?: PolicyEvaluatorOptions): PolicyEvaluatorResult;
+//# sourceMappingURL=selectionPolicies.d.ts.map

package/dist/harness/selectionPolicies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionPolicies.d.ts","sourceRoot":"","sources":["../../src/harness/selectionPolicies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CACN,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkKD,wBAAgB,gBAAgB,IAAI,eAAe,CAElD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAMjE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GACtB,CACD,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,KAC7B,qBAAqB,CAGzB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,gBAAgB,EAAE,EAC9B,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAGvB"}

package/dist/harness/selectionPolicies.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * GAP-HADAPT-008: Harness Selection Policies.
+ *
+ * Configurable policies for harness selection: cost-optimized,
+ * latency-optimized, capability-first, user-preferred.
+ * Policy evaluator scores candidates using selectHarness from capabilityRouter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultPolicy = getDefaultPolicy;
+exports.getPolicyByName = getPolicyByName;
+exports.createPolicyEvaluator = createPolicyEvaluator;
+exports.evaluatePolicy = evaluatePolicy;
+const capabilityRouter_1 = require("./capabilityRouter");
+const types_1 = require("./types");
+// ---------------------------------------------------------------------------
+// Policy implementations
+// ---------------------------------------------------------------------------
+const capabilityFirstPolicy = {
+    name: "capability-first",
+    description: "Select the harness with the highest capability score",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "capability-first", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        return {
+            selected: result.selected,
+            policyName: "capability-first",
+            score: result.score,
+            reason: `Selected ${result.selected.name} with score ${result.score}`,
+            routingResult: result,
+        };
+    },
+};
+const costOptimizedPolicy = {
+    name: "cost-optimized",
+    description: "Prefer harnesses with fewer capabilities (proxy for lower cost)",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "cost-optimized", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        // Among eligible candidates (those that passed the threshold), pick the one
+        // with the fewest capabilities — a proxy for cost
+        const eligible = result.scores
+            .filter((s) => !s.disqualified && s.total >= 50)
+            .map((s) => s.name);
+        const eligibleCandidates = candidates.filter((c) => eligible.includes(c.name));
+        if (eligibleCandidates.length === 0) {
+            return { selected: null, policyName: "cost-optimized", score: 0, reason: "No eligible candidate", routingResult: result };
+        }
+        // Sort by fewest capabilities ascending
+        const sorted = [...eligibleCandidates].sort((a, b) => a.capabilities.length - b.capabilities.length);
+        const pick = sorted[0];
+        const pickScore = result.scores.find((s) => s.name === pick.name);
+        return {
+            selected: pick,
+            policyName: "cost-optimized",
+            score: pickScore?.total ?? 0,
+            reason: `Selected ${pick.name} (fewest capabilities: ${pick.capabilities.length})`,
+            routingResult: result,
+        };
+    },
+};
+const latencyOptimizedPolicy = {
+    name: "latency-optimized",
+    description: "Prefer harnesses with Programmatic + StopHook for lowest latency",
+    evaluate(candidates, requirements) {
+        const result = (0, capabilityRouter_1.selectHarness)(requirements, candidates);
+        if (!result) {
+            return { selected: null, policyName: "latency-optimized", score: 0, reason: "No candidate met threshold", routingResult: null };
+        }
+        const eligible = result.scores
+            .filter((s) => !s.disqualified && s.total >= 50)
+            .map((s) => s.name);
+        const eligibleCandidates = candidates.filter((c) => eligible.includes(c.name));
+        if (eligibleCandidates.length === 0) {
+            return { selected: null, policyName: "latency-optimized", score: 0, reason: "No eligible candidate", routingResult: result };
+        }
+        // Score: +2 for StopHook, +2 for Programmatic, +1 for SessionBinding
+        const latencyScore = (c) => {
+            let s = 0;
+            if (c.capabilities.includes(types_1.HarnessCapability.StopHook))
+                s += 2;
+            if (c.capabilities.includes(types_1.HarnessCapability.Programmatic))
+                s += 2;
+            if (c.capabilities.includes(types_1.HarnessCapability.SessionBinding))
+                s += 1;
+            return s;
+        };
+        const sorted = [...eligibleCandidates].sort((a, b) => latencyScore(b) - latencyScore(a));
+        const pick = sorted[0];
+        const pickScore = result.scores.find((s) => s.name === pick.name);
+        return {
+            selected: pick,
+            policyName: "latency-optimized",
+            score: pickScore?.total ?? 0,
+            reason: `Selected ${pick.name} (latency-optimized: StopHook+Programmatic)`,
+            routingResult: result,
+        };
+    },
+};
+const userPreferredPolicy = {
+    name: "user-preferred",
+    description: "Select the user-preferred harness if it qualifies, else fall back to capability-first",
+    evaluate(candidates, requirements, options) {
+        const preferred = options?.preferredHarness;
+        if (preferred) {
+            // Try routing with the preferred harness hint
+            const augmented = {
+                ...requirements,
+                preferredHarness: preferred,
+            };
+            const result = (0, capabilityRouter_1.selectHarness)(augmented, candidates);
+            if (result && result.selected.name === preferred) {
+                return {
+                    selected: result.selected,
+                    policyName: "user-preferred",
+                    score: result.score,
+                    reason: `Selected user-preferred harness ${preferred}`,
+                    routingResult: result,
+                };
+            }
+        }
+        // Fall back to capability-first
+        const fallback = capabilityFirstPolicy.evaluate(candidates, requirements);
+        return {
+            ...fallback,
+            policyName: "user-preferred",
+            reason: preferred
+                ? `Preferred harness '${preferred}' not available, fell back to ${fallback.selected?.name ?? "none"}`
+                : fallback.reason,
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+const POLICIES = {
+    "capability-first": capabilityFirstPolicy,
+    "cost-optimized": costOptimizedPolicy,
+    "latency-optimized": latencyOptimizedPolicy,
+    "user-preferred": userPreferredPolicy,
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function getDefaultPolicy() {
+    return POLICIES["capability-first"];
+}
+function getPolicyByName(name) {
+    const policy = POLICIES[name];
+    if (!policy) {
+        throw new TypeError(`Unknown selection policy: ${String(name)}`);
+    }
+    return policy;
+}
+function createPolicyEvaluator(policy) {
+    return (candidates, requirements, options) => policy.evaluate(candidates, requirements, options);
+}
+function evaluatePolicy(policyName, candidates, requirements, options) {
+    const policy = getPolicyByName(policyName);
+    return policy.evaluate(candidates, requirements, options);
+}