agentplane 0.3.9 → 0.3.11

package/dist/runtime/task-intake/types.d.ts

@@ -0,0 +1,117 @@
+import type { ApprovalSettings, TaskDocVersion } from "@agentplaneorg/core";
+import type { TaskBackendCapabilities, TaskData, TaskOrigin } from "../../backends/task-backend.js";
+import type { BehaviorLayer } from "../behavior/index.js";
+import type { AgentplaneCapabilityRegistry } from "../capabilities/index.js";
+import type { ResolvedExecutionProfileRuntime } from "../execution-profile/index.js";
+import type { ResolvedHarnessContract } from "../harness/index.js";
+export type TaskIntakeSourceId = "task_new" | "task_create" | "recipe_scenario" | "import" | "system";
+export type TaskIntakeSourceRef = {
+    id: TaskIntakeSourceId;
+    detail: string;
+};
+export type TaskIntakeInputKind = "text" | "constraint" | "task_reference" | "recipe_reference" | "output";
+export type TaskIntakeInput = {
+    kind: TaskIntakeInputKind;
+    label?: string;
+    value: string;
+    required?: boolean;
+};
+export type TaskIntakePrecedence = {
+    behavior_order: BehaviorLayer[];
+    extension_layer: "recipes";
+};
+export type TaskIntakeRuntime = {
+    repo: {
+        git_root: string;
+        agentplane_dir: string;
+        workflow_dir: string;
+    };
+    workflow: {
+        mode: ResolvedHarnessContract["workflow"]["mode"];
+    };
+    backend: {
+        id: string;
+        config_path: string;
+        capabilities: TaskBackendCapabilities | null;
+        supports_generate_task_id: boolean;
+        supports_bulk_write: boolean;
+    };
+    task_contract: {
+        doc_sections: string[];
+        required_doc_sections: string[];
+        verify_required_tags: string[];
+    };
+    policy: {
+        approvals: Required<ApprovalSettings>;
+        protected_paths: ResolvedHarnessContract["policy"]["protected_paths"];
+        unsafe_actions_requiring_explicit_user_ok: string[];
+    };
+    execution_profile: ResolvedExecutionProfileRuntime;
+    capabilities: AgentplaneCapabilityRegistry;
+    precedence: TaskIntakePrecedence;
+};
+export type TaskIntakeContext = {
+    runtime: TaskIntakeRuntime;
+    source: TaskIntakeSourceRef;
+    requested_outcome: string;
+    requested_owner?: string;
+    requested_tags: string[];
+    requested_verify: string[];
+    requested_dependencies: string[];
+    parent_task_id?: string;
+    inputs: TaskIntakeInput[];
+};
+export type ClarificationQuestion = {
+    id: string;
+    question: string;
+    reason: string;
+    required: boolean;
+    target_field?: string;
+    accepted_values?: string[];
+};
+export type ClarificationContract = {
+    context: TaskIntakeContext;
+    status: "ready" | "needs_input";
+    assumptions: string[];
+    questions: ClarificationQuestion[];
+};
+export type TaskGraphDependency = {
+    from: string;
+    to: string;
+    kind: "depends_on";
+};
+export type TaskGraphDraftTask = {
+    draft_id: string;
+    title: string;
+    description: string;
+    owner: string;
+    priority: TaskData["priority"];
+    origin?: TaskOrigin | null;
+    tags: string[];
+    verify: string[];
+    depends_on: string[];
+    doc: string;
+    doc_version?: TaskDocVersion;
+    id_source?: string;
+};
+export type TaskGraphDraft = {
+    context: TaskIntakeContext;
+    clarification: ClarificationContract;
+    summary: string;
+    tasks: TaskGraphDraftTask[];
+    dependencies: TaskGraphDependency[];
+    warnings: string[];
+};
+export type TaskMaterializationEntry = {
+    draft_id: string;
+    task_id: string;
+    task: TaskData;
+    readme_path: string;
+};
+export type TaskMaterializationPlan = {
+    context: TaskIntakeContext;
+    summary: string;
+    backend: TaskIntakeRuntime["backend"];
+    tasks: TaskMaterializationEntry[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/task-intake/types.d.ts.map

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

package/dist/runtime/task-intake/types.js

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

package/dist/shared/env.d.ts

@@ -1,3 +1,4 @@
 export declare function parseDotEnv(text: string): Record<string, string>;
+export declare function isDotEnvLoadedKey(key: string, env?: NodeJS.ProcessEnv): boolean;
 export declare function loadDotEnv(rootDir: string): Promise<void>;
 //# sourceMappingURL=env.d.ts.map

package/dist/shared/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/shared/env.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BhE;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc/D"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/shared/env.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BhE;AAmBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE5F;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/D"}

package/dist/shared/env.js

@@ -1,5 +1,6 @@
 import { readFile } from "node:fs/promises";
 import path from "node:path";
+const DOTENV_LOADED_KEYS_ENV = "AGENTPLANE_DOTENV_LOADED_KEYS";
 export function parseDotEnv(text) {
     const out = {};
     const lines = text.split(/\r?\n/u);
@@ -30,6 +31,23 @@ export function parseDotEnv(text) {
     }
     return out;
 }
+function readDotEnvLoadedKeys(env = process.env) {
+    const raw = env[DOTENV_LOADED_KEYS_ENV]?.trim() ?? "";
+    if (!raw)
+        return new Set();
+    return new Set(raw
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean));
+}
+function recordDotEnvLoadedKey(key, env = process.env) {
+    const keys = readDotEnvLoadedKeys(env);
+    keys.add(key);
+    env[DOTENV_LOADED_KEYS_ENV] = [...keys].toSorted().join(",");
+}
+export function isDotEnvLoadedKey(key, env = process.env) {
+    return readDotEnvLoadedKeys(env).has(key);
+}
 export async function loadDotEnv(rootDir) {
     const envPath = path.join(rootDir, ".env");
     let text = "";
@@ -44,6 +62,9 @@ export async function loadDotEnv(rootDir) {
     }
     const parsed = parseDotEnv(text);
     for (const [key, value] of Object.entries(parsed)) {
-        process.env[key] ??= value;
+        if (process.env[key] !== undefined)
+            continue;
+        process.env[key] = value;
+        recordDotEnvLoadedKey(key);
     }
 }

package/dist/shared/protected-paths.d.ts

@@ -9,6 +9,10 @@ export declare function taskArtifactPrefixes(opts: {
     workflowDir?: string;
     taskId?: string;
 }): string[];
+export declare const POLICY_PATH_PREFIXES: readonly ["AGENTS.md", "CLAUDE.md", "packages/agentplane/assets/AGENTS.md", "packages/agentplane/assets/policy", ".agentplane/policy", ".agentplane/agents"];
+export declare const CONFIG_PATH_PREFIXES: readonly [".agentplane/config.json", ".agentplane/backends"];
+export declare const HOOK_PATH_PREFIXES: readonly ["lefthook.yml"];
+export declare const CI_PATH_PREFIXES: readonly [".github/workflows", ".github/actions"];
 export declare function protectedPathAllowPrefixes(opts: {
     tasksPath: string;
     workflowDir?: string;

package/dist/shared/protected-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protected-paths.d.ts","sourceRoot":"","sources":["../../src/shared/protected-paths.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,EAAE,CAOX;AAYD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,EAAE,CAkBX;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAkBvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iBAAiB,GAAG,IAAI,CAsC3B"}
+{"version":3,"file":"protected-paths.d.ts","sourceRoot":"","sources":["../../src/shared/protected-paths.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,EAAE,CAOX;AAED,eAAO,MAAM,oBAAoB,8JAOvB,CAAC;AACX,eAAO,MAAM,oBAAoB,8DAA+D,CAAC;AACjG,eAAO,MAAM,kBAAkB,2BAA4B,CAAC;AAC5D,eAAO,MAAM,gBAAgB,mDAAoD,CAAC;AAElF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,EAAE,CAkBX;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAkBvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iBAAiB,GAAG,IAAI,CAwC3B"}

package/dist/shared/protected-paths.js

@@ -16,15 +16,17 @@ export function taskArtifactPrefixes(opts) {
         out.add(workflowPrefix);
     return [...out].toSorted((a, b) => a.localeCompare(b));
 }
-const POLICY_PATH_PREFIXES = [
+export const POLICY_PATH_PREFIXES = [
     "AGENTS.md",
     "CLAUDE.md",
     "packages/agentplane/assets/AGENTS.md",
+    "packages/agentplane/assets/policy",
+    ".agentplane/policy",
     ".agentplane/agents",
 ];
-const CONFIG_PATH_PREFIXES = [".agentplane/config.json", ".agentplane/backends"];
-const HOOK_PATH_PREFIXES = ["lefthook.yml"];
-const CI_PATH_PREFIXES = [".github/workflows", ".github/actions"];
+export const CONFIG_PATH_PREFIXES = [".agentplane/config.json", ".agentplane/backends"];
+export const HOOK_PATH_PREFIXES = ["lefthook.yml"];
+export const CI_PATH_PREFIXES = [".github/workflows", ".github/actions"];
 export function protectedPathAllowPrefixes(opts) {
     const out = new Set();
     if (opts.allowTasks) {
@@ -83,6 +85,8 @@ export function protectedPathKindForFile(opts) {
     if (p === "AGENTS.md" ||
         p === "CLAUDE.md" ||
         p === "packages/agentplane/assets/AGENTS.md" ||
+        gitPathIsUnderPrefix(p, "packages/agentplane/assets/policy") ||
+        gitPathIsUnderPrefix(p, ".agentplane/policy") ||
         gitPathIsUnderPrefix(p, ".agentplane/agents")) {
         return "policy";
     }

package/dist/usecases/context/resolve-context.d.ts

@@ -2,18 +2,67 @@ import type { AgentplaneConfig, ResolvedProject } from "@agentplaneorg/core";
 import type { Adapters } from "../../adapters/index.js";
 import { type CommandContext } from "../../commands/shared/task-backend.js";
 import { PolicyEngine } from "../../policy/engine.js";
-export type UsecaseContext = {
+import { type ApprovalRuntime } from "../../runtime/approvals/index.js";
+import { type AgentplaneCapabilityRegistry } from "../../runtime/capabilities/index.js";
+import { type ResolvedExecutionProfileRuntime } from "../../runtime/execution-profile/index.js";
+import { type FrameworkExplainPayload } from "../../runtime/explain/index.js";
+import { type ResolvedHarnessContract } from "../../runtime/harness/index.js";
+import { type FrameworkProtocolSurface } from "../../runtime/protocol/index.js";
+import { type TaskIntakeRuntime } from "../../runtime/task-intake/index.js";
+export type AgentplaneRepositoryContext = {
+    git_root: string;
+    agentplane_dir: string;
+    workflow_dir: string;
+};
+export type AgentplaneBackendContext = {
+    id: string;
+    config_path: string;
+    capabilities: CommandContext["taskBackend"]["capabilities"] | null;
+    task_backend: CommandContext["taskBackend"];
+};
+export type ReadOnlyUsecaseContext = {
     command: CommandContext;
-    adapters: Adapters;
+    project: CommandContext["resolvedProject"];
+    repo: AgentplaneRepositoryContext;
+    config: CommandContext["config"];
+    backend: AgentplaneBackendContext;
+    harness: ResolvedHarnessContract;
+    capabilities: AgentplaneCapabilityRegistry;
+    execution: ResolvedHarnessContract["execution"];
+    executionProfile: ResolvedExecutionProfileRuntime;
+    taskIntake: TaskIntakeRuntime;
+    frameworkExplain: FrameworkExplainPayload;
+    frameworkProtocol: FrameworkProtocolSurface;
+    approvals: ResolvedHarnessContract["policy"]["approvals"];
     policy: PolicyEngine;
+    approvalRuntime: ApprovalRuntime;
 };
-export type ReadOnlyUsecaseContext = Pick<UsecaseContext, "command">;
-export declare function resolveContext(opts: {
+export type UsecaseContext = ReadOnlyUsecaseContext & {
+    adapters: Adapters;
+};
+export type AgentplaneReadOnlyExecutionContext = ReadOnlyUsecaseContext;
+export type AgentplaneExecutionContext = UsecaseContext;
+export declare function resolveCommandContext(opts: {
     cwd: string;
     rootOverride?: string | null;
     resolvedProject?: ResolvedProject;
     config?: AgentplaneConfig;
 }): Promise<CommandContext>;
-export declare function makeReadOnlyUsecaseContext(command: CommandContext): ReadOnlyUsecaseContext;
-export declare function makeUsecaseContext(command: CommandContext): UsecaseContext;
+export declare function resolveContext(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    resolvedProject?: ResolvedProject;
+    config?: AgentplaneConfig;
+}): Promise<ReadOnlyUsecaseContext>;
+export declare const resolveReadOnlyExecutionContext: typeof resolveContext;
+export declare function resolveExecutionContext(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    resolvedProject?: ResolvedProject;
+    config?: AgentplaneConfig;
+}): Promise<AgentplaneExecutionContext>;
+export declare function makeReadOnlyUsecaseContext(command: CommandContext): Promise<ReadOnlyUsecaseContext>;
+export declare function makeUsecaseContext(command: CommandContext): Promise<UsecaseContext>;
+export declare const makeReadOnlyExecutionContext: typeof makeReadOnlyUsecaseContext;
+export declare const makeExecutionContext: typeof makeUsecaseContext;
 //# sourceMappingURL=resolve-context.d.ts.map

package/dist/usecases/context/resolve-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-context.d.ts","sourceRoot":"","sources":["../../../src/usecases/context/resolve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AAErE,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,OAAO,CAAC,cAAc,CAAC,CAO1B;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,CAE1F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAM1E"}
+{"version":3,"file":"resolve-context.d.ts","sourceRoot":"","sources":["../../../src/usecases/context/resolve-context.ts"],"names":[],"mappings":"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"}

package/dist/usecases/context/resolve-context.js

@@ -1,7 +1,16 @@
 import { buildAdapters } from "../../adapters/index.js";
 import { loadCommandContext } from "../../commands/shared/task-backend.js";
 import { PolicyEngine } from "../../policy/engine.js";
-export async function resolveContext(opts) {
+import { createApprovalRuntime } from "../../runtime/approvals/index.js";
+import { resolveTaskBackendCapabilityRegistry, } from "../../runtime/capabilities/index.js";
+import { resolveExecutionProfileRuntime, } from "../../runtime/execution-profile/index.js";
+import { buildFrameworkExplainPayload, } from "../../runtime/explain/index.js";
+import { resolveHarnessFromCommandContext, } from "../../runtime/harness/index.js";
+import { buildFrameworkProtocolSurface, } from "../../runtime/protocol/index.js";
+import { createTaskIntakeRuntime, } from "../../runtime/task-intake/index.js";
+const READ_ONLY_CONTEXT_CACHE = new WeakMap();
+const USECASE_CONTEXT_CACHE = new WeakMap();
+export async function resolveCommandContext(opts) {
     return await loadCommandContext({
         cwd: opts.cwd,
         rootOverride: opts.rootOverride ?? null,
@@ -9,13 +18,94 @@ export async function resolveContext(opts) {
         config: opts.config,
     });
 }
-export function makeReadOnlyUsecaseContext(command) {
-    return { command };
+export async function resolveContext(opts) {
+    const command = await resolveCommandContext(opts);
+    return await makeReadOnlyUsecaseContext(command);
+}
+export const resolveReadOnlyExecutionContext = resolveContext;
+export async function resolveExecutionContext(opts) {
+    const command = await resolveCommandContext(opts);
+    return await makeUsecaseContext(command);
+}
+export async function makeReadOnlyUsecaseContext(command) {
+    let cached = READ_ONLY_CONTEXT_CACHE.get(command);
+    if (!cached) {
+        cached = buildReadOnlyUsecaseContext(command);
+        READ_ONLY_CONTEXT_CACHE.set(command, cached);
+    }
+    return await cached;
+}
+export async function makeUsecaseContext(command) {
+    let cached = USECASE_CONTEXT_CACHE.get(command);
+    if (!cached) {
+        cached = buildUsecaseContext(command);
+        USECASE_CONTEXT_CACHE.set(command, cached);
+    }
+    return await cached;
+}
+export const makeReadOnlyExecutionContext = makeReadOnlyUsecaseContext;
+export const makeExecutionContext = makeUsecaseContext;
+async function buildReadOnlyUsecaseContext(command) {
+    const harness = await resolveHarnessFromCommandContext(command);
+    const policy = new PolicyEngine();
+    const executionProfile = resolveExecutionProfileRuntime(command.config);
+    const capabilities = resolveTaskBackendCapabilityRegistry({
+        backend_id: command.backendId,
+        capabilities: command.taskBackend.capabilities ?? null,
+    });
+    const taskIntake = createTaskIntakeRuntime({
+        repo: {
+            git_root: command.resolvedProject.gitRoot,
+            agentplane_dir: command.resolvedProject.agentplaneDir,
+            workflow_dir: command.config.paths.workflow_dir,
+        },
+        backend: {
+            id: command.backendId,
+            config_path: command.backendConfigPath,
+            capabilities: command.taskBackend.capabilities ?? null,
+            supports_generate_task_id: typeof command.taskBackend.generateTaskId === "function",
+            supports_bulk_write: typeof command.taskBackend.writeTasks === "function",
+        },
+        harness,
+        execution_profile: executionProfile,
+        capabilities,
+    });
+    const frameworkExplain = buildFrameworkExplainPayload({
+        harness,
+        capabilities,
+        execution_profile: executionProfile,
+        task_intake: taskIntake,
+    });
+    return {
+        command,
+        project: command.resolvedProject,
+        repo: {
+            git_root: command.resolvedProject.gitRoot,
+            agentplane_dir: command.resolvedProject.agentplaneDir,
+            workflow_dir: command.config.paths.workflow_dir,
+        },
+        config: command.config,
+        backend: {
+            id: command.backendId,
+            config_path: command.backendConfigPath,
+            capabilities: command.taskBackend.capabilities ?? null,
+            task_backend: command.taskBackend,
+        },
+        harness,
+        capabilities,
+        execution: harness.execution,
+        executionProfile,
+        taskIntake,
+        frameworkExplain,
+        frameworkProtocol: buildFrameworkProtocolSurface({ explain: frameworkExplain }),
+        approvals: harness.policy.approvals,
+        policy,
+        approvalRuntime: createApprovalRuntime({ config: command.config, policy }),
+    };
 }
-export function makeUsecaseContext(command) {
+async function buildUsecaseContext(command) {
     return {
-        ...makeReadOnlyUsecaseContext(command),
+        ...(await makeReadOnlyUsecaseContext(command)),
         adapters: buildAdapters(command),
-        policy: new PolicyEngine(),
     };
 }

package/dist/usecases/task/task-list-usecase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-list-usecase.d.ts","sourceRoot":"","sources":["../../../src/usecases/task/task-list-usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CASlB"}
+{"version":3,"file":"task-list-usecase.d.ts","sourceRoot":"","sources":["../../../src/usecases/task/task-list-usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB"}

package/dist/usecases/task/task-list-usecase.js

@@ -1,9 +1,15 @@
 import { cmdTaskList } from "../../commands/task/list.js";
 import { makeReadOnlyUsecaseContext } from "../context/resolve-context.js";
 export async function taskListUsecase(opts) {
-    const uctx = makeReadOnlyUsecaseContext(opts.command);
+    const execution = await makeReadOnlyUsecaseContext(opts.command);
+    void execution.policy.evaluate({
+        action: "task_list",
+        config: execution.config,
+        taskId: "",
+        git: { stagedPaths: [] },
+    });
     return await cmdTaskList({
-        ctx: uctx.command,
+        ctx: execution.command,
         cwd: opts.cli.cwd,
         rootOverride: opts.cli.rootOverride,
         filters: opts.filters,

package/dist/usecases/task/task-new-usecase.js

@@ -1,15 +1,15 @@
 import { runTaskNewParsed } from "../../commands/task/new.js";
 import { makeUsecaseContext } from "../context/resolve-context.js";
 export async function taskNewUsecase(opts) {
-    const uctx = makeUsecaseContext(opts.command);
-    void uctx.policy.evaluate({
+    const execution = await makeUsecaseContext(opts.command);
+    void execution.policy.evaluate({
         action: "task_new",
-        config: uctx.command.config,
+        config: execution.config,
         taskId: "",
         git: { stagedPaths: [] },
     });
     return await runTaskNewParsed({
-        ctx: uctx.command,
+        ctx: execution.command,
         cwd: opts.cli.cwd,
         rootOverride: opts.cli.rootOverride,
         parsed: opts.parsed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -55,7 +55,7 @@
     "prepublishOnly": "node ../../scripts/enforce-github-publish.mjs && npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.3.9",
+    "@agentplaneorg/core": "0.3.11",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {