agentplane 0.3.9 → 0.3.11

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

@@ -0,0 +1,84 @@
+export type IncidentRegistryEntryState = "open" | "stabilized" | "promoted";
+export type IncidentRegistryEntry = {
+    id: string;
+    date: string;
+    scope: string;
+    failure: string;
+    rule: string;
+    evidence: string;
+    enforcement: string;
+    state: IncidentRegistryEntryState;
+    tags: string[];
+    match: string[];
+    advice: string | null;
+    sourceTask: string | null;
+    fixability: "external" | "repo-fixable" | null;
+    rawFields: Record<string, string>;
+    line: number;
+};
+export type IncidentRegistry = {
+    entries: IncidentRegistryEntry[];
+};
+export type IncidentFindingCandidate = {
+    observation: string;
+    impact: string | null;
+    resolution: string | null;
+    promotion: string | null;
+    incidentScope: string | null;
+    incidentRule: string | null;
+    incidentAdvice: string | null;
+    incidentTags: string[];
+    incidentMatch: string[];
+    incidentExternal: boolean;
+    incidentInternal: boolean;
+    fixability: "external" | "repo-fixable" | null;
+    line: number;
+    rawFields: Record<string, string>;
+};
+export type IncidentSkippedFinding = {
+    observation: string;
+    line: number;
+    reason: "not_marked_external_or_promotable";
+    rawFields: Record<string, string>;
+};
+export type IncidentPromotionTaskContext = {
+    id: string;
+    title: string;
+    description: string;
+    scope?: string | null;
+    tags: string[];
+    commitHash?: string | null;
+};
+export type IncidentPromotionDraft = {
+    candidate: IncidentFindingCandidate;
+    entry: IncidentRegistryEntry;
+    fingerprint: string;
+};
+export type IncidentPromotionIssue = {
+    candidate: IncidentFindingCandidate;
+    missingFields: string[];
+};
+export type IncidentCollectionPlan = {
+    candidates: IncidentFindingCandidate[];
+    skipped: IncidentSkippedFinding[];
+    promotable: IncidentPromotionDraft[];
+    duplicates: IncidentPromotionDraft[];
+    issues: IncidentPromotionIssue[];
+    findingsTextPresent: boolean;
+    structuredFindingCount: number;
+};
+export type IncidentAdviceQuery = {
+    taskId?: string;
+    title: string;
+    description: string;
+    scope?: string | null;
+    tags: string[];
+};
+export type IncidentAdviceMatch = {
+    entry: IncidentRegistryEntry;
+    score: number;
+    matchedTags: string[];
+    matchedTerms: string[];
+    scopeMatched: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/runtime/incidents/types.js

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

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

@@ -0,0 +1,3 @@
+export { AGENTPLANE_PROTOCOL_COMPATIBILITY, buildFrameworkExplainProtocolResult, buildFrameworkProtocolSurface, buildProtocolErrorResult, buildProtocolSuccessResult, } from "./resolve.js";
+export { AGENTPLANE_PROTOCOL_SCHEMA_VERSION, type AgentplaneProtocolBase, type AgentplaneProtocolCompatibility, type AgentplaneProtocolError, type AgentplaneProtocolErrorResult, type AgentplaneProtocolKind, type AgentplaneProtocolResult, type AgentplaneProtocolSchemaVersion, type AgentplaneProtocolStatus, type AgentplaneProtocolSuccessResult, type FrameworkExplainProtocolResult, type FrameworkProtocolSurface, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,mCAAmC,EACnC,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kCAAkC,EAClC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,GAC9B,MAAM,YAAY,CAAC"}

package/dist/runtime/protocol/index.js

@@ -0,0 +1,2 @@
+export { AGENTPLANE_PROTOCOL_COMPATIBILITY, buildFrameworkExplainProtocolResult, buildFrameworkProtocolSurface, buildProtocolErrorResult, buildProtocolSuccessResult, } from "./resolve.js";
+export { AGENTPLANE_PROTOCOL_SCHEMA_VERSION, } from "./types.js";

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

@@ -0,0 +1,16 @@
+import type { FrameworkExplainPayload } from "../explain/index.js";
+import { type AgentplaneProtocolCompatibility, type AgentplaneProtocolError, type AgentplaneProtocolErrorResult, type AgentplaneProtocolKind, type AgentplaneProtocolSuccessResult, type FrameworkExplainProtocolResult, type FrameworkProtocolSurface } from "./types.js";
+export declare const AGENTPLANE_PROTOCOL_COMPATIBILITY: AgentplaneProtocolCompatibility;
+export declare function buildProtocolSuccessResult<TKind extends AgentplaneProtocolKind, TData>(opts: {
+    kind: TKind;
+    data: TData;
+}): AgentplaneProtocolSuccessResult<TKind, TData>;
+export declare function buildProtocolErrorResult<TKind extends AgentplaneProtocolKind>(opts: {
+    kind: TKind;
+    error: AgentplaneProtocolError;
+}): AgentplaneProtocolErrorResult<TKind>;
+export declare function buildFrameworkExplainProtocolResult(explain: FrameworkExplainPayload): FrameworkExplainProtocolResult;
+export declare function buildFrameworkProtocolSurface(opts: {
+    explain: FrameworkExplainPayload;
+}): FrameworkProtocolSurface;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/protocol/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC9B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iCAAiC,EAAE,+BAK/C,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,sBAAsB,EAAE,KAAK,EAAE,IAAI,EAAE;IAC5F,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;CACb,GAAG,+BAA+B,CAAC,KAAK,EAAE,KAAK,CAAC,CAQhD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,sBAAsB,EAAE,IAAI,EAAE;IACnF,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,uBAAuB,CAAC;CAChC,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAQvC;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,uBAAuB,GAC/B,8BAA8B,CAKhC;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,uBAAuB,CAAC;CAClC,GAAG,wBAAwB,CAI3B"}

package/dist/runtime/protocol/resolve.js

@@ -0,0 +1,36 @@
+import { AGENTPLANE_PROTOCOL_SCHEMA_VERSION, } from "./types.js";
+export const AGENTPLANE_PROTOCOL_COMPATIBILITY = {
+    strategy: "additive",
+    breaking_changes_require_schema_version: true,
+    additive_fields_allowed: true,
+    new_result_kinds_allowed: true,
+};
+export function buildProtocolSuccessResult(opts) {
+    return {
+        schema_version: AGENTPLANE_PROTOCOL_SCHEMA_VERSION,
+        kind: opts.kind,
+        status: "ok",
+        compatibility: structuredClone(AGENTPLANE_PROTOCOL_COMPATIBILITY),
+        data: structuredClone(opts.data),
+    };
+}
+export function buildProtocolErrorResult(opts) {
+    return {
+        schema_version: AGENTPLANE_PROTOCOL_SCHEMA_VERSION,
+        kind: opts.kind,
+        status: "error",
+        compatibility: structuredClone(AGENTPLANE_PROTOCOL_COMPATIBILITY),
+        error: structuredClone(opts.error),
+    };
+}
+export function buildFrameworkExplainProtocolResult(explain) {
+    return buildProtocolSuccessResult({
+        kind: "framework.explain",
+        data: explain,
+    });
+}
+export function buildFrameworkProtocolSurface(opts) {
+    return {
+        explain: buildFrameworkExplainProtocolResult(opts.explain),
+    };
+}

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

@@ -0,0 +1,36 @@
+import type { FrameworkExplainPayload } from "../explain/index.js";
+export declare const AGENTPLANE_PROTOCOL_SCHEMA_VERSION: 1;
+export type AgentplaneProtocolSchemaVersion = typeof AGENTPLANE_PROTOCOL_SCHEMA_VERSION;
+export type AgentplaneProtocolStatus = "ok" | "error";
+export type AgentplaneProtocolKind = string;
+export type AgentplaneProtocolCompatibility = {
+    strategy: "additive";
+    breaking_changes_require_schema_version: true;
+    additive_fields_allowed: true;
+    new_result_kinds_allowed: true;
+};
+export type AgentplaneProtocolBase<TKind extends AgentplaneProtocolKind> = {
+    schema_version: AgentplaneProtocolSchemaVersion;
+    kind: TKind;
+    compatibility: AgentplaneProtocolCompatibility;
+};
+export type AgentplaneProtocolSuccessResult<TKind extends AgentplaneProtocolKind, TData> = AgentplaneProtocolBase<TKind> & {
+    status: "ok";
+    data: TData;
+};
+export type AgentplaneProtocolError = {
+    code: string;
+    message: string;
+    retryable?: boolean;
+    details?: Record<string, unknown>;
+};
+export type AgentplaneProtocolErrorResult<TKind extends AgentplaneProtocolKind> = AgentplaneProtocolBase<TKind> & {
+    status: "error";
+    error: AgentplaneProtocolError;
+};
+export type AgentplaneProtocolResult<TKind extends AgentplaneProtocolKind, TData> = AgentplaneProtocolSuccessResult<TKind, TData> | AgentplaneProtocolErrorResult<TKind>;
+export type FrameworkExplainProtocolResult = AgentplaneProtocolSuccessResult<"framework.explain", FrameworkExplainPayload>;
+export type FrameworkProtocolSurface = {
+    explain: FrameworkExplainProtocolResult;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/protocol/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,eAAO,MAAM,kCAAkC,EAAG,CAAU,CAAC;AAE7D,MAAM,MAAM,+BAA+B,GAAG,OAAO,kCAAkC,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,OAAO,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE5C,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,UAAU,CAAC;IACrB,uCAAuC,EAAE,IAAI,CAAC;IAC9C,uBAAuB,EAAE,IAAI,CAAC;IAC9B,wBAAwB,EAAE,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,sBAAsB,IAAI;IACzE,cAAc,EAAE,+BAA+B,CAAC;IAChD,IAAI,EAAE,KAAK,CAAC;IACZ,aAAa,EAAE,+BAA+B,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,+BAA+B,CACzC,KAAK,SAAS,sBAAsB,EACpC,KAAK,IACH,sBAAsB,CAAC,KAAK,CAAC,GAAG;IAClC,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,6BAA6B,CAAC,KAAK,SAAS,sBAAsB,IAC5E,sBAAsB,CAAC,KAAK,CAAC,GAAG;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEJ,MAAM,MAAM,wBAAwB,CAAC,KAAK,SAAS,sBAAsB,EAAE,KAAK,IAC5E,+BAA+B,CAAC,KAAK,EAAE,KAAK,CAAC,GAC7C,6BAA6B,CAAC,KAAK,CAAC,CAAC;AAEzC,MAAM,MAAM,8BAA8B,GAAG,+BAA+B,CAC1E,mBAAmB,EACnB,uBAAuB,CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,8BAA8B,CAAC;CACzC,CAAC"}

package/dist/runtime/protocol/types.js

@@ -0,0 +1 @@
+export const AGENTPLANE_PROTOCOL_SCHEMA_VERSION = 1;

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

@@ -0,0 +1,3 @@
+export { createClarificationContract, createTaskGraphDraft, createTaskIntakeContext, createTaskIntakeRuntime, materializeTaskGraphDraft, } from "./resolve.js";
+export type { ClarificationContract, ClarificationQuestion, TaskGraphDependency, TaskGraphDraft, TaskGraphDraftTask, TaskIntakeContext, TaskIntakeInput, TaskIntakeInputKind, TaskIntakePrecedence, TaskIntakeRuntime, TaskIntakeSourceId, TaskIntakeSourceRef, TaskMaterializationEntry, TaskMaterializationPlan, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/task-intake/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1 @@
+export { createClarificationContract, createTaskGraphDraft, createTaskIntakeContext, createTaskIntakeRuntime, materializeTaskGraphDraft, } from "./resolve.js";

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

@@ -0,0 +1,48 @@
+import type { AgentplaneCapabilityRegistry } from "../capabilities/index.js";
+import type { ResolvedExecutionProfileRuntime } from "../execution-profile/index.js";
+import type { ResolvedHarnessContract } from "../harness/index.js";
+import type { ClarificationContract, ClarificationQuestion, TaskGraphDependency, TaskGraphDraft, TaskGraphDraftTask, TaskIntakeContext, TaskIntakeInput, TaskIntakeRuntime, TaskMaterializationPlan } from "./types.js";
+export declare function createTaskIntakeRuntime(opts: {
+    repo: TaskIntakeRuntime["repo"];
+    backend: {
+        id: string;
+        config_path: string;
+        capabilities: TaskIntakeRuntime["backend"]["capabilities"];
+        supports_generate_task_id: boolean;
+        supports_bulk_write: boolean;
+    };
+    harness: Pick<ResolvedHarnessContract, "workflow" | "task" | "policy">;
+    execution_profile: ResolvedExecutionProfileRuntime;
+    capabilities: AgentplaneCapabilityRegistry;
+}): TaskIntakeRuntime;
+export declare function createTaskIntakeContext(opts: {
+    runtime: TaskIntakeRuntime;
+    source: TaskIntakeContext["source"];
+    requested_outcome: string;
+    requested_owner?: string;
+    requested_tags?: string[];
+    requested_verify?: string[];
+    requested_dependencies?: string[];
+    parent_task_id?: string;
+    inputs?: TaskIntakeInput[];
+}): TaskIntakeContext;
+export declare function createClarificationContract(opts: {
+    context: TaskIntakeContext;
+    assumptions?: string[];
+    questions?: ClarificationQuestion[];
+}): ClarificationContract;
+export declare function createTaskGraphDraft(opts: {
+    context: TaskIntakeContext;
+    clarification: ClarificationContract;
+    summary: string;
+    tasks: TaskGraphDraftTask[];
+    dependencies?: TaskGraphDependency[];
+    warnings?: string[];
+}): TaskGraphDraft;
+export declare function materializeTaskGraphDraft(opts: {
+    draft: TaskGraphDraft;
+    task_ids?: Record<string, string>;
+    allocateTaskId?: (task: TaskGraphDraftTask, index: number) => Promise<string>;
+    created_at?: string;
+}): Promise<TaskMaterializationPlan>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/task-intake/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAEjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAgOpB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;QAC3D,yBAAyB,EAAE,OAAO,CAAC;QACnC,mBAAmB,EAAE,OAAO,CAAC;KAC9B,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC;IACvE,iBAAiB,EAAE,+BAA+B,CAAC;IACnD,YAAY,EAAE,4BAA4B,CAAC;CAC5C,GAAG,iBAAiB,CAoCpB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B,GAAG,iBAAiB,CAepB;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACrC,GAAG,qBAAqB,CAQxB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,aAAa,EAAE,qBAAqB,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,cAAc,CAUjB;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyCnC"}

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

@@ -0,0 +1,316 @@
+import path from "node:path";
+import { buildTaskDocState } from "../../shared/task-doc-state.js";
+const TASK_INTAKE_BEHAVIOR_ORDER = [
+    "harness",
+    "extension",
+    "user",
+    "builtin",
+];
+function dedupeTrimmed(values) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of values) {
+        const value = String(raw ?? "").trim();
+        if (!value || seen.has(value))
+            continue;
+        seen.add(value);
+        out.push(value);
+    }
+    return out;
+}
+function normalizeOutcome(value) {
+    const normalized = value.trim();
+    if (!normalized)
+        throw new Error("Task intake context requires a non-empty requested outcome.");
+    return normalized;
+}
+function normalizeSourceDetail(value) {
+    const normalized = value.trim();
+    if (!normalized)
+        throw new Error("Task intake source detail must be non-empty.");
+    return normalized;
+}
+function normalizeInputs(inputs) {
+    return inputs
+        .map((input) => ({
+        kind: input.kind,
+        ...(input.label?.trim() ? { label: input.label.trim() } : {}),
+        value: normalizeOutcome(input.value),
+        ...(input.required === true ? { required: true } : {}),
+    }))
+        .toSorted((left, right) => left.kind.localeCompare(right.kind) ||
+        (left.label ?? "").localeCompare(right.label ?? "") ||
+        left.value.localeCompare(right.value));
+}
+function normalizeQuestions(questions) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of questions) {
+        const id = raw.id.trim();
+        const question = raw.question.trim();
+        const reason = raw.reason.trim();
+        if (!id)
+            throw new Error("Clarification questions require a non-empty id.");
+        if (!question)
+            throw new Error(`Clarification question ${id} requires question text.`);
+        if (!reason)
+            throw new Error(`Clarification question ${id} requires a reason.`);
+        if (seen.has(id))
+            throw new Error(`Clarification question ids must be unique: ${id}`);
+        seen.add(id);
+        out.push({
+            id,
+            question,
+            reason,
+            required: raw.required === true,
+            ...(raw.target_field?.trim() ? { target_field: raw.target_field.trim() } : {}),
+            ...(raw.accepted_values
+                ? { accepted_values: dedupeTrimmed(raw.accepted_values).toSorted() }
+                : {}),
+        });
+    }
+    return out.toSorted((left, right) => left.id.localeCompare(right.id));
+}
+function normalizeDraftTasks(tasks) {
+    if (tasks.length === 0)
+        throw new Error("Task graph draft requires at least one task.");
+    const seen = new Set();
+    return tasks.map((task) => {
+        const draft_id = task.draft_id.trim();
+        if (!draft_id)
+            throw new Error("Task graph draft tasks require a non-empty draft_id.");
+        if (seen.has(draft_id))
+            throw new Error(`Duplicate task graph draft id: ${draft_id}`);
+        seen.add(draft_id);
+        const title = task.title.trim();
+        if (!title)
+            throw new Error(`Task graph draft task ${draft_id} requires a title.`);
+        const description = task.description.trim();
+        if (!description) {
+            throw new Error(`Task graph draft task ${draft_id} requires a description.`);
+        }
+        const owner = task.owner.trim();
+        if (!owner)
+            throw new Error(`Task graph draft task ${draft_id} requires an owner.`);
+        const doc = task.doc.trim();
+        if (!doc)
+            throw new Error(`Task graph draft task ${draft_id} requires a task document.`);
+        return {
+            draft_id,
+            title,
+            description,
+            owner,
+            priority: task.priority,
+            ...(task.origin ? { origin: structuredClone(task.origin) } : {}),
+            tags: dedupeTrimmed(task.tags).toSorted(),
+            verify: dedupeTrimmed(task.verify).toSorted(),
+            depends_on: dedupeTrimmed(task.depends_on).toSorted(),
+            doc,
+            ...(task.doc_version ? { doc_version: task.doc_version } : {}),
+            ...(task.id_source?.trim() ? { id_source: task.id_source.trim() } : {}),
+        };
+    });
+}
+function normalizeDependencies(tasks, dependencies) {
+    const taskIds = new Set(tasks.map((task) => task.draft_id));
+    const seen = new Set();
+    const out = [];
+    for (const dependency of dependencies) {
+        if (!taskIds.has(dependency.from)) {
+            throw new Error(`Task graph dependency source is unknown: ${dependency.from}`);
+        }
+        if (!taskIds.has(dependency.to)) {
+            throw new Error(`Task graph dependency target is unknown: ${dependency.to}`);
+        }
+        const signature = `${dependency.from}:${dependency.kind}:${dependency.to}`;
+        if (seen.has(signature))
+            continue;
+        seen.add(signature);
+        out.push({
+            from: dependency.from,
+            to: dependency.to,
+            kind: "depends_on",
+        });
+    }
+    return out.toSorted((left, right) => left.from.localeCompare(right.from) ||
+        left.kind.localeCompare(right.kind) ||
+        left.to.localeCompare(right.to));
+}
+function resolveTaskIds(opts) {
+    const provided = new Map();
+    const taskIds = opts.task_ids ?? {};
+    for (const task of opts.tasks) {
+        const taskId = taskIds[task.draft_id]?.trim();
+        if (taskId)
+            provided.set(task.draft_id, taskId);
+    }
+    return (async () => {
+        if (provided.size === opts.tasks.length)
+            return provided;
+        if (!opts.allocateTaskId) {
+            throw new Error("Task graph materialization requires task_ids for every draft task or an allocateTaskId callback.");
+        }
+        for (const [index, task] of opts.tasks.entries()) {
+            if (provided.has(task.draft_id))
+                continue;
+            const allocatedTaskId = await opts.allocateTaskId(task, index);
+            const taskId = allocatedTaskId.trim();
+            if (!taskId) {
+                throw new Error(`Task id allocator returned an empty id for draft ${task.draft_id}.`);
+            }
+            provided.set(task.draft_id, taskId);
+        }
+        return provided;
+    })();
+}
+function buildMaterializedTask(opts) {
+    const normalizedDoc = buildTaskDocState({
+        doc: opts.draftTask.doc,
+        owner: opts.draftTask.owner,
+        updatedBy: opts.draftTask.owner,
+        version: opts.draftTask.doc_version ?? 3,
+        updatedAt: opts.created_at,
+    });
+    const task = {
+        id: opts.task_id,
+        title: opts.draftTask.title,
+        description: opts.draftTask.description,
+        status: "TODO",
+        priority: opts.draftTask.priority,
+        owner: opts.draftTask.owner,
+        revision: 1,
+        ...(opts.draftTask.origin ? { origin: structuredClone(opts.draftTask.origin) } : {}),
+        depends_on: dedupeTrimmed([
+            ...opts.draftTask.depends_on,
+            ...opts.internal_dependencies,
+        ]).toSorted(),
+        tags: [...opts.draftTask.tags],
+        verify: [...opts.draftTask.verify],
+        comments: [],
+        events: [],
+        doc_version: normalizedDoc.doc_version,
+        doc_updated_at: normalizedDoc.doc_updated_at,
+        doc_updated_by: normalizedDoc.doc_updated_by,
+        id_source: opts.draftTask.id_source ?? "generated",
+        doc: normalizedDoc.doc,
+        sections: normalizedDoc.sections,
+    };
+    return {
+        draft_id: opts.draftTask.draft_id,
+        task_id: opts.task_id,
+        task,
+        readme_path: path.join(opts.context.runtime.repo.git_root, opts.context.runtime.repo.workflow_dir, opts.task_id, "README.md"),
+    };
+}
+export function createTaskIntakeRuntime(opts) {
+    return {
+        repo: {
+            git_root: opts.repo.git_root,
+            agentplane_dir: opts.repo.agentplane_dir,
+            workflow_dir: opts.repo.workflow_dir,
+        },
+        workflow: {
+            mode: opts.harness.workflow.mode,
+        },
+        backend: {
+            id: opts.backend.id,
+            config_path: opts.backend.config_path,
+            capabilities: opts.backend.capabilities ? structuredClone(opts.backend.capabilities) : null,
+            supports_generate_task_id: opts.backend.supports_generate_task_id,
+            supports_bulk_write: opts.backend.supports_bulk_write,
+        },
+        task_contract: {
+            doc_sections: [...opts.harness.task.doc_sections],
+            required_doc_sections: [...opts.harness.task.required_doc_sections],
+            verify_required_tags: [...opts.harness.task.verify_required_tags],
+        },
+        policy: {
+            approvals: structuredClone(opts.harness.policy.approvals),
+            protected_paths: structuredClone(opts.harness.policy.protected_paths),
+            unsafe_actions_requiring_explicit_user_ok: [
+                ...opts.harness.policy.unsafe_actions_requiring_explicit_user_ok,
+            ],
+        },
+        execution_profile: structuredClone(opts.execution_profile),
+        capabilities: structuredClone(opts.capabilities),
+        precedence: {
+            behavior_order: [...TASK_INTAKE_BEHAVIOR_ORDER],
+            extension_layer: "recipes",
+        },
+    };
+}
+export function createTaskIntakeContext(opts) {
+    return {
+        runtime: structuredClone(opts.runtime),
+        source: {
+            id: opts.source.id,
+            detail: normalizeSourceDetail(opts.source.detail),
+        },
+        requested_outcome: normalizeOutcome(opts.requested_outcome),
+        ...(opts.requested_owner?.trim() ? { requested_owner: opts.requested_owner.trim() } : {}),
+        requested_tags: dedupeTrimmed(opts.requested_tags ?? []).toSorted(),
+        requested_verify: dedupeTrimmed(opts.requested_verify ?? []).toSorted(),
+        requested_dependencies: dedupeTrimmed(opts.requested_dependencies ?? []).toSorted(),
+        ...(opts.parent_task_id?.trim() ? { parent_task_id: opts.parent_task_id.trim() } : {}),
+        inputs: normalizeInputs(opts.inputs ?? []),
+    };
+}
+export function createClarificationContract(opts) {
+    const questions = normalizeQuestions(opts.questions ?? []);
+    return {
+        context: structuredClone(opts.context),
+        status: questions.some((question) => question.required) ? "needs_input" : "ready",
+        assumptions: dedupeTrimmed(opts.assumptions ?? []),
+        questions,
+    };
+}
+export function createTaskGraphDraft(opts) {
+    const tasks = normalizeDraftTasks(opts.tasks);
+    return {
+        context: structuredClone(opts.context),
+        clarification: structuredClone(opts.clarification),
+        summary: normalizeOutcome(opts.summary),
+        tasks,
+        dependencies: normalizeDependencies(tasks, opts.dependencies ?? []),
+        warnings: dedupeTrimmed(opts.warnings ?? []),
+    };
+}
+export async function materializeTaskGraphDraft(opts) {
+    if (opts.draft.clarification.status === "needs_input") {
+        throw new Error("Task graph materialization requires clarification.status=ready.");
+    }
+    const created_at = opts.created_at ?? new Date().toISOString();
+    const taskIds = await resolveTaskIds({
+        tasks: opts.draft.tasks,
+        task_ids: opts.task_ids,
+        allocateTaskId: opts.allocateTaskId,
+    });
+    const tasks = opts.draft.tasks.map((draftTask) => {
+        const task_id = taskIds.get(draftTask.draft_id);
+        if (!task_id) {
+            throw new Error(`Task id resolution lost draft task ${draftTask.draft_id}.`);
+        }
+        const internal_dependencies = opts.draft.dependencies
+            .filter((dependency) => dependency.from === draftTask.draft_id)
+            .map((dependency) => {
+            const resolved = taskIds.get(dependency.to);
+            if (!resolved) {
+                throw new Error(`Task id resolution lost dependency target ${dependency.to}.`);
+            }
+            return resolved;
+        });
+        return buildMaterializedTask({
+            context: opts.draft.context,
+            draftTask,
+            task_id,
+            internal_dependencies,
+            created_at,
+        });
+    });
+    return {
+        context: structuredClone(opts.draft.context),
+        summary: opts.draft.summary,
+        backend: structuredClone(opts.draft.context.runtime.backend),
+        tasks,
+    };
+}