agentplane 0.3.9 → 0.3.10

package/dist/runtime/harness/resolve-from-command-context.js

@@ -0,0 +1,11 @@
+import { resolveHarnessContract } from "./resolve.js";
+export async function resolveHarnessFromCommandContext(ctx) {
+    ctx.memo.harness ??= resolveHarnessContract({
+        project: ctx.resolvedProject,
+        config: ctx.config,
+        backendId: ctx.backendId,
+        backendConfigPath: ctx.backendConfigPath,
+        backendCapabilities: ctx.taskBackend.capabilities,
+    });
+    return await ctx.memo.harness;
+}

package/dist/runtime/harness/resolve.d.ts

@@ -0,0 +1,13 @@
+import { type AgentplaneConfig, type ResolvedProject } from "@agentplaneorg/core";
+import type { TaskBackendCapabilities } from "../../backends/task-backend.js";
+import { type PolicyGatewayFlavor } from "../../shared/policy-gateway.js";
+import type { ResolvedHarnessContract } from "./types.js";
+export declare function resolveHarnessContract(opts: {
+    project: ResolvedProject;
+    config: AgentplaneConfig;
+    backendId: string;
+    backendConfigPath: string;
+    backendCapabilities?: TaskBackendCapabilities | null;
+    fallbackPolicyGatewayFlavor?: PolicyGatewayFlavor;
+}): Promise<ResolvedHarnessContract>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/runtime/harness/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/harness/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAQxC,OAAO,KAAK,EAEV,uBAAuB,EAGxB,MAAM,YAAY,CAAC;AA+FpB,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACrD,2BAA2B,CAAC,EAAE,mBAAmB,CAAC;CACnD,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAkFnC"}

package/dist/runtime/harness/resolve.js

@@ -0,0 +1,146 @@
+import path from "node:path";
+import { applyExecutionToApprovals, } from "@agentplaneorg/core";
+import { normalizeGitPathPrefix } from "../../shared/git-path.js";
+import { resolvePolicyGatewayForRepo, } from "../../shared/policy-gateway.js";
+import { CI_PATH_PREFIXES, CONFIG_PATH_PREFIXES, HOOK_PATH_PREFIXES, POLICY_PATH_PREFIXES, } from "../../shared/protected-paths.js";
+function source(id, detail) {
+    return { id, detail };
+}
+function mergeSourceRefs(...groups) {
+    const out = [];
+    const seen = new Set();
+    for (const group of groups) {
+        for (const entry of group) {
+            const key = `${entry.id}:${entry.detail}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(entry);
+        }
+    }
+    return out;
+}
+function mergePathPrefixes(...groups) {
+    const out = [];
+    const seen = new Set();
+    for (const group of groups) {
+        for (const candidate of group) {
+            const normalized = normalizeGitPathPrefix(candidate);
+            if (!normalized || seen.has(normalized))
+                continue;
+            seen.add(normalized);
+            out.push(normalized);
+        }
+    }
+    return out.toSorted((left, right) => left.localeCompare(right));
+}
+function backendRestrictions(capabilities) {
+    return {
+        canonical_source: capabilities?.canonical_source ?? "local",
+        projection: capabilities?.projection ?? "canonical",
+        projection_read_mode: capabilities?.projection_read_mode ?? "native",
+        reads_from_projection_by_default: capabilities?.reads_from_projection_by_default ?? false,
+        writes_task_readmes: capabilities?.writes_task_readmes ?? false,
+        supports_task_revisions: capabilities?.supports_task_revisions ?? false,
+        supports_revision_guarded_writes: capabilities?.supports_revision_guarded_writes ?? false,
+        may_access_network_on_read: capabilities?.may_access_network_on_read ?? false,
+        may_access_network_on_write: capabilities?.may_access_network_on_write ?? false,
+        supports_projection_refresh: capabilities?.supports_projection_refresh ?? false,
+        supports_push_sync: capabilities?.supports_push_sync ?? false,
+        supports_snapshot_export: capabilities?.supports_snapshot_export ?? false,
+    };
+}
+function resolveProtectedPaths(opts) {
+    const builtinSource = source("builtin", "shared protected path defaults");
+    const configSource = source("config", ".agentplane/config.json");
+    const gatewaySource = source("policy_gateway", opts.policyGatewayFileName);
+    const backendSource = source("backend", opts.backendConfigPath);
+    const tasks = mergePathPrefixes([opts.config.paths.tasks_path, opts.config.paths.workflow_dir]);
+    const policy = mergePathPrefixes([...POLICY_PATH_PREFIXES], [opts.policyGatewayFileName, opts.config.paths.agents_dir]);
+    const backendConfigDir = normalizeGitPathPrefix(path.dirname(opts.backendConfigPath));
+    const config = mergePathPrefixes([...CONFIG_PATH_PREFIXES], [opts.backendConfigPath, backendConfigDir]);
+    const hooks = mergePathPrefixes([...HOOK_PATH_PREFIXES]);
+    const ci = mergePathPrefixes([...CI_PATH_PREFIXES]);
+    return {
+        groups: { tasks, policy, config, hooks, ci },
+        trace: mergeSourceRefs(tasks.length > 0 ? [configSource] : [], policy.length > 0 ? [builtinSource, gatewaySource, configSource] : [], config.length > 0 ? [builtinSource, backendSource] : [], hooks.length > 0 ? [builtinSource] : [], ci.length > 0 ? [builtinSource] : []),
+    };
+}
+function gatewaySource(fileName) {
+    return source("policy_gateway", fileName);
+}
+export async function resolveHarnessContract(opts) {
+    const policyGateway = await resolvePolicyGatewayForRepo({
+        gitRoot: opts.project.gitRoot,
+        fallbackFlavor: opts.fallbackPolicyGatewayFlavor,
+    });
+    const approvals = applyExecutionToApprovals({
+        execution: opts.config.execution,
+        approvals: opts.config.agents?.approvals ?? {
+            require_plan: false,
+            require_network: false,
+            require_verify: false,
+            require_force: false,
+        },
+    });
+    const protectedPaths = resolveProtectedPaths({
+        config: opts.config,
+        policyGatewayFileName: policyGateway.fileName,
+        backendConfigPath: opts.backendConfigPath,
+    });
+    return {
+        repo: {
+            ...opts.project,
+            policy_gateway: policyGateway,
+            tasks_backend_config_path: opts.backendConfigPath,
+        },
+        workflow: {
+            mode: opts.config.workflow_mode,
+            status_commit_policy: opts.config.status_commit_policy,
+            finish_auto_status_commit: opts.config.finish_auto_status_commit,
+            task_prefix: opts.config.branch.task_prefix,
+            paths: structuredClone(opts.config.paths),
+        },
+        task: {
+            doc_sections: [...opts.config.tasks.doc.sections],
+            required_doc_sections: [...opts.config.tasks.doc.required_sections],
+            verify_required_tags: [...opts.config.tasks.verify.required_tags],
+            verify_steps_required_tags: [...(opts.config.tasks.verify.require_steps_for_tags ?? [])],
+            verify_steps_required_primary: [
+                ...(opts.config.tasks.verify.require_steps_for_primary ?? []),
+            ],
+            verification_required_primary: [
+                ...(opts.config.tasks.verify.require_verification_for_primary ?? []),
+            ],
+            spike_tag: opts.config.tasks.verify.spike_tag,
+            enforce_verify_steps_on_plan_approve: opts.config.tasks.verify.enforce_on_plan_approve,
+            enforce_verify_steps_on_start_without_plan: opts.config.tasks.verify.enforce_on_start_when_no_plan,
+            comments: structuredClone(opts.config.tasks.comments),
+            closure_commit_requires_approval: opts.config.closure_commit_requires_approval,
+        },
+        policy: {
+            approvals,
+            unsafe_actions_requiring_explicit_user_ok: [
+                ...opts.config.execution.unsafe_actions_requiring_explicit_user_ok,
+            ],
+            protected_paths: protectedPaths.groups,
+        },
+        execution: structuredClone(opts.config.execution),
+        backend: {
+            id: opts.backendId,
+            config_path: opts.backendConfigPath,
+            capabilities: opts.backendCapabilities ? structuredClone(opts.backendCapabilities) : null,
+            restrictions: backendRestrictions(opts.backendCapabilities),
+        },
+        trace: {
+            repo: [source("project", opts.project.gitRoot)],
+            workflow: [source("config", ".agentplane/config.json")],
+            task_contract: [source("config", ".agentplane/config.json")],
+            policy_gateway: [gatewaySource(policyGateway.fileName)],
+            approval_requirements: mergeSourceRefs([source("config", ".agentplane/config.json")], [source("execution_profile", opts.config.execution.profile)]),
+            protected_paths: protectedPaths.trace,
+            execution: [source("config", ".agentplane/config.json")],
+            backend: mergeSourceRefs([source("backend", opts.backendId)], [source("config", opts.backendConfigPath)]),
+        },
+    };
+}

package/dist/runtime/harness/types.d.ts

@@ -0,0 +1,65 @@
+import type { ApprovalSettings, AgentplaneConfig, ResolvedProject } from "@agentplaneorg/core";
+import type { TaskBackendCapabilities } from "../../backends/task-backend.js";
+import type { ProtectedPathKind } from "../../shared/protected-paths.js";
+import type { PolicyGatewayResolution } from "../../shared/policy-gateway.js";
+export type HarnessSourceId = "builtin" | "project" | "config" | "execution_profile" | "policy_gateway" | "backend";
+export type HarnessSourceRef = {
+    id: HarnessSourceId;
+    detail: string;
+};
+export type HarnessTraceField = "repo" | "workflow" | "task_contract" | "policy_gateway" | "approval_requirements" | "protected_paths" | "execution" | "backend";
+export type ResolvedProtectedPathGroups = Record<ProtectedPathKind, string[]>;
+export type ResolvedHarnessTrace = Record<HarnessTraceField, HarnessSourceRef[]>;
+export type ResolvedHarnessContract = {
+    repo: ResolvedProject & {
+        policy_gateway: PolicyGatewayResolution;
+        tasks_backend_config_path: string;
+    };
+    workflow: {
+        mode: AgentplaneConfig["workflow_mode"];
+        status_commit_policy: AgentplaneConfig["status_commit_policy"];
+        finish_auto_status_commit: boolean;
+        task_prefix: string;
+        paths: AgentplaneConfig["paths"];
+    };
+    task: {
+        doc_sections: string[];
+        required_doc_sections: string[];
+        verify_required_tags: string[];
+        verify_steps_required_tags: string[];
+        verify_steps_required_primary: string[];
+        verification_required_primary: string[];
+        spike_tag: string;
+        enforce_verify_steps_on_plan_approve: boolean;
+        enforce_verify_steps_on_start_without_plan: boolean;
+        comments: AgentplaneConfig["tasks"]["comments"];
+        closure_commit_requires_approval: boolean;
+    };
+    policy: {
+        approvals: Required<ApprovalSettings>;
+        unsafe_actions_requiring_explicit_user_ok: string[];
+        protected_paths: ResolvedProtectedPathGroups;
+    };
+    execution: AgentplaneConfig["execution"];
+    backend: {
+        id: string;
+        config_path: string;
+        capabilities: TaskBackendCapabilities | null;
+        restrictions: {
+            canonical_source: TaskBackendCapabilities["canonical_source"];
+            projection: TaskBackendCapabilities["projection"];
+            projection_read_mode: TaskBackendCapabilities["projection_read_mode"];
+            reads_from_projection_by_default: boolean;
+            writes_task_readmes: boolean;
+            supports_task_revisions: boolean;
+            supports_revision_guarded_writes: boolean;
+            may_access_network_on_read: boolean;
+            may_access_network_on_write: boolean;
+            supports_projection_refresh: boolean;
+            supports_push_sync: boolean;
+            supports_snapshot_export: boolean;
+        };
+    };
+    trace: ResolvedHarnessTrace;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/harness/types.d.ts.map

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

package/dist/runtime/harness/types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/incidents/index.d.ts

@@ -0,0 +1,3 @@
+export type { IncidentAdviceMatch, IncidentAdviceQuery, IncidentCollectionPlan, IncidentFindingCandidate, IncidentPromotionDraft, IncidentPromotionIssue, IncidentPromotionTaskContext, IncidentRegistry, IncidentRegistryEntry, IncidentRegistryEntryState, } from "./types.js";
+export { appendIncidentRegistryEntries, buildIncidentAdviceQueryFromTask, createIncidentRegistrySkeleton, extractIncidentCandidatesFromFindings, formatIncidentRegistryEntry, parseIncidentRegistry, planIncidentCollection, renderIncidentAdvice, resolveIncidentAdviceMatches, } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/incidents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/incidents/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,8BAA8B,EAC9B,qCAAqC,EACrC,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,cAAc,CAAC"}

package/dist/runtime/incidents/index.js

@@ -0,0 +1 @@
+export { appendIncidentRegistryEntries, buildIncidentAdviceQueryFromTask, createIncidentRegistrySkeleton, extractIncidentCandidatesFromFindings, formatIncidentRegistryEntry, parseIncidentRegistry, planIncidentCollection, renderIncidentAdvice, resolveIncidentAdviceMatches, } from "./resolve.js";

package/dist/runtime/incidents/resolve.d.ts

@@ -0,0 +1,26 @@
+import type { IncidentAdviceMatch, IncidentAdviceQuery, IncidentCollectionPlan, IncidentFindingCandidate, IncidentPromotionTaskContext, IncidentRegistry, IncidentRegistryEntry } from "./types.js";
+export declare function createIncidentRegistrySkeleton(): string;
+export declare function parseIncidentRegistry(text: string): IncidentRegistry;
+export declare function formatIncidentRegistryEntry(entry: IncidentRegistryEntry): string;
+export declare function appendIncidentRegistryEntries(currentText: string, entries: readonly IncidentRegistryEntry[]): string;
+export declare function extractIncidentCandidatesFromFindings(findings: string): IncidentFindingCandidate[];
+export declare function planIncidentCollection(opts: {
+    task: IncidentPromotionTaskContext;
+    findings: string;
+    registry: IncidentRegistry;
+    now?: Date;
+}): IncidentCollectionPlan;
+export declare function buildIncidentAdviceQueryFromTask(opts: {
+    taskId: string;
+    title: string;
+    description: string;
+    scope?: string | null;
+    tags: readonly string[];
+}): IncidentAdviceQuery;
+export declare function resolveIncidentAdviceMatches(opts: {
+    query: IncidentAdviceQuery;
+    registry: IncidentRegistry;
+    limit?: number;
+}): IncidentAdviceMatch[];
+export declare function renderIncidentAdvice(matches: readonly IncidentAdviceMatch[]): string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/runtime/incidents/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/incidents/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EAGxB,4BAA4B,EAC5B,gBAAgB,EAChB,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAuGpB,wBAAgB,8BAA8B,IAAI,MAAM,CAgCvD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAkFpE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAgBhF;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,qBAAqB,EAAE,GACxC,MAAM,CAQR;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,GACf,wBAAwB,EAAE,CAwF5B;AA4DD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,sBAAsB,CAiCzB;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,GAAG,mBAAmB,CAQtB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,mBAAmB,EAAE,CA4BxB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,CAcpF"}