p-dev-harness 0.3.1 → 0.4.0

package/dist/workflow/canonical-product-development-workflow.js

@@ -0,0 +1,425 @@
+/**
+ * Canonical product-development workflow descriptor.
+ *
+ * Product semantics only — no source filenames or function references.
+ * Audit traceability lives in tests, architecture docs, and PR evidence.
+ */
+/**
+ * Linear provides Duplicate as a built-in system status for superseded issues.
+ * It is not creatable via setup and may be absent on some teams.
+ * Absence must NOT block harness runs.
+ */
+export const DUPLICATE_STATUS_CONTRACT = {
+    linearGuarantee: "optional-system-terminal",
+    requiredForPreflight: false,
+    creatable: false,
+    systemManaged: true,
+    validateWhenPresent: true,
+};
+export const DEPRECATED_CANONICAL_STATUS_NAMES = ["Plan Review"];
+export const CANONICAL_DISPATCH_TRIGGER_STATUS_NAMES = [
+    "Ready for Planning",
+    "Ready for Build",
+    "PR Open",
+    "Needs Revision",
+    "Ready to Merge",
+];
+export const CANONICAL_STATUSES = [
+    {
+        key: "backlog",
+        name: "Backlog",
+        category: "backlog",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "human-gate",
+        suggestedPosition: { x: 0, y: 0 },
+        graphGroup: "intake",
+    },
+    {
+        key: "ready-for-planning",
+        name: "Ready for Planning",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: true,
+        actorRole: "planner-agent",
+        agentPhaseKey: "planning",
+        inProgressStatusKey: "planning",
+        suggestedPosition: { x: 280, y: 0 },
+        graphGroup: "planning",
+    },
+    {
+        key: "planning",
+        name: "Planning",
+        category: "started",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "planner-agent",
+        agentPhaseKey: "planning",
+        suggestedPosition: { x: 560, y: 0 },
+        graphGroup: "planning",
+    },
+    {
+        key: "ready-for-build",
+        name: "Ready for Build",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: true,
+        actorRole: "implementation-agent",
+        agentPhaseKey: "implementation",
+        inProgressStatusKey: "building",
+        suggestedPosition: { x: 840, y: 0 },
+        graphGroup: "build",
+    },
+    {
+        key: "building",
+        name: "Building",
+        category: "started",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "implementation-agent",
+        agentPhaseKey: "implementation",
+        suggestedPosition: { x: 1120, y: 0 },
+        graphGroup: "build",
+    },
+    {
+        key: "pr-open",
+        name: "PR Open",
+        category: "started",
+        role: "dispatch-trigger",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: true,
+        actorRole: "handoff-runner",
+        suggestedPosition: { x: 1400, y: 0 },
+        graphGroup: "build",
+    },
+    {
+        key: "pm-review",
+        name: "PM Review",
+        category: "started",
+        role: "human-gate",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "human-gate",
+        suggestedPosition: { x: 1680, y: 0 },
+        graphGroup: "review",
+    },
+    {
+        key: "engineering-review",
+        name: "Engineering Review",
+        category: "started",
+        role: "human-gate",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "human-gate",
+        suggestedPosition: { x: 1960, y: 0 },
+        graphGroup: "review",
+    },
+    {
+        key: "needs-revision",
+        name: "Needs Revision",
+        category: "unstarted",
+        role: "dispatch-trigger",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: true,
+        actorRole: "revision-agent",
+        agentPhaseKey: "revision",
+        inProgressStatusKey: "revising",
+        suggestedPosition: { x: 1680, y: 200 },
+        graphGroup: "review",
+    },
+    {
+        key: "revising",
+        name: "Revising",
+        category: "started",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "revision-agent",
+        agentPhaseKey: "revision",
+        suggestedPosition: { x: 1400, y: 200 },
+        graphGroup: "review",
+    },
+    {
+        key: "ready-to-merge",
+        name: "Ready to Merge",
+        category: "started",
+        role: "dispatch-trigger",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: true,
+        actorRole: "merge-runner",
+        inProgressStatusKey: "merging",
+        suggestedPosition: { x: 2240, y: 0 },
+        graphGroup: "merge",
+    },
+    {
+        key: "merging",
+        name: "Merging",
+        category: "started",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "merge-runner",
+        suggestedPosition: { x: 2520, y: 0 },
+        graphGroup: "merge",
+    },
+    {
+        key: "merged-to-dev",
+        name: "Merged to Dev",
+        category: "completed",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "production-sync-runner",
+        suggestedPosition: { x: 2800, y: 0 },
+        graphGroup: "merge",
+    },
+    {
+        key: "merged-deployed",
+        name: "Merged / Deployed",
+        category: "completed",
+        role: "transitional",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "none",
+        suggestedPosition: { x: 3080, y: 0 },
+        graphGroup: "merge",
+    },
+    {
+        key: "blocked",
+        name: "Blocked",
+        category: "started",
+        role: "terminal",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "none",
+        suggestedPosition: { x: 1120, y: 400 },
+        graphGroup: "terminal",
+    },
+    {
+        key: "canceled",
+        name: "Canceled",
+        category: "canceled",
+        role: "terminal",
+        creatable: true,
+        systemManaged: false,
+        automationTrigger: false,
+        actorRole: "none",
+        suggestedPosition: { x: 1400, y: 400 },
+        graphGroup: "terminal",
+    },
+    {
+        key: "duplicate",
+        name: "Duplicate",
+        category: "duplicate",
+        role: "system-managed",
+        creatable: false,
+        systemManaged: true,
+        automationTrigger: false,
+        actorRole: "none",
+        suggestedPosition: { x: 1680, y: 400 },
+        graphGroup: "terminal",
+    },
+];
+export const CANONICAL_AGENT_PHASES = [
+    {
+        key: "planning",
+        label: "Planning",
+        sourceStatusKey: "ready-for-planning",
+        inProgressStatusKey: "planning",
+        successDestinationKey: "ready-for-build",
+        failureDestinationKey: "blocked",
+        actorRole: "planner-agent",
+        supportsModelConfiguration: true,
+    },
+    {
+        key: "implementation",
+        label: "Implementation",
+        sourceStatusKey: "ready-for-build",
+        inProgressStatusKey: "building",
+        successDestinationKey: "pr-open",
+        failureDestinationKey: "blocked",
+        actorRole: "implementation-agent",
+        supportsModelConfiguration: true,
+    },
+    {
+        key: "revision",
+        label: "Revision",
+        sourceStatusKey: "needs-revision",
+        inProgressStatusKey: "revising",
+        successDestinationKey: "pm-review",
+        failureDestinationKey: "blocked",
+        actorRole: "revision-agent",
+        supportsModelConfiguration: true,
+    },
+    {
+        key: "merge-integration-repair",
+        label: "Merge integration repair",
+        sourceStatusKey: "merging",
+        inProgressStatusKey: "merging",
+        successDestinationKey: "merging",
+        failureDestinationKey: "blocked",
+        actorRole: "merge-runner",
+        supportsModelConfiguration: true,
+    },
+];
+export const CANONICAL_HUMAN_GATES = [
+    {
+        statusKey: "backlog",
+        label: "Backlog triage",
+        allowedDestinations: ["ready-for-planning", "ready-for-build"],
+    },
+    {
+        statusKey: "pm-review",
+        label: "PM review decision",
+        allowedDestinations: ["needs-revision", "engineering-review"],
+    },
+    {
+        statusKey: "engineering-review",
+        label: "Engineering review decision",
+        allowedDestinations: ["needs-revision", "ready-to-merge"],
+    },
+];
+/** Agent-phase automation transitions (success/failure/recovery). */
+export const CANONICAL_AUTOMATION_TRANSITIONS = [
+    { from: "ready-for-planning", to: "planning", label: "Planning", kind: "system" },
+    { from: "planning", to: "ready-for-build", label: "Ready for Build", kind: "success" },
+    { from: "planning", to: "blocked", label: "Blocked", kind: "failure" },
+    { from: "ready-for-build", to: "building", label: "Building", kind: "system" },
+    { from: "building", to: "pr-open", label: "PR Open", kind: "success" },
+    { from: "building", to: "blocked", label: "Blocked", kind: "failure" },
+    { from: "pr-open", to: "pm-review", label: "PM Review", kind: "success" },
+    { from: "pr-open", to: "blocked", label: "Blocked", kind: "failure" },
+    { from: "needs-revision", to: "revising", label: "Revising", kind: "system" },
+    { from: "revising", to: "pm-review", label: "PM Review", kind: "success" },
+    { from: "revising", to: "blocked", label: "Blocked", kind: "failure" },
+    { from: "ready-to-merge", to: "merging", label: "Merging", kind: "system" },
+    { from: "merging", to: "blocked", label: "Blocked", kind: "failure" },
+];
+/** Human-gate transitions. */
+export const CANONICAL_HUMAN_TRANSITIONS = [
+    { from: "backlog", to: "ready-for-planning", label: "Ready for Planning", kind: "human" },
+    { from: "backlog", to: "ready-for-build", label: "Ready for Build", kind: "human" },
+    { from: "pm-review", to: "needs-revision", label: "Needs Revision", kind: "human" },
+    { from: "pm-review", to: "engineering-review", label: "Engineering Review", kind: "human" },
+    {
+        from: "engineering-review",
+        to: "needs-revision",
+        label: "Needs Revision",
+        kind: "human",
+    },
+    {
+        from: "engineering-review",
+        to: "ready-to-merge",
+        label: "Ready to Merge",
+        kind: "human",
+    },
+];
+export const CANONICAL_MERGE_PATHS = [
+    {
+        variant: "integration-then-production",
+        transitions: [
+            { from: "merging", to: "merged-to-dev", label: "Merged to Dev", kind: "success" },
+            {
+                from: "merged-to-dev",
+                to: "merged-deployed",
+                label: "Merged / Deployed",
+                kind: "system",
+            },
+        ],
+    },
+    {
+        variant: "direct-production",
+        transitions: [
+            {
+                from: "merging",
+                to: "merged-deployed",
+                label: "Merged / Deployed",
+                kind: "success",
+            },
+        ],
+    },
+];
+export const CANONICAL_WORKFLOW_FINGERPRINT = "canonical-product-development-v1";
+export function lookupCanonicalStatus(key) {
+    return CANONICAL_STATUSES.find((status) => status.key === key);
+}
+export function lookupCanonicalStatusByExactName(name) {
+    return CANONICAL_STATUSES.find((status) => status.name === name);
+}
+/** Non-authoritative convenience lookup (webhook/dispatch helpers only). */
+export function lookupCanonicalStatusByName(name) {
+    const normalized = name.trim().toLowerCase();
+    return CANONICAL_STATUSES.find((status) => status.name.toLowerCase() === normalized);
+}
+export function lookupCanonicalAgentPhase(key) {
+    return CANONICAL_AGENT_PHASES.find((phase) => phase.key === key);
+}
+export function getCanonicalDispatchTriggerStatusNames() {
+    return CANONICAL_DISPATCH_TRIGGER_STATUS_NAMES;
+}
+export function isCanonicalDispatchTriggerStatusName(name) {
+    const normalized = name.trim().toLowerCase();
+    return CANONICAL_DISPATCH_TRIGGER_STATUS_NAMES.some((status) => status.toLowerCase() === normalized);
+}
+export function getRequiredCanonicalStatusNames(options) {
+    return CANONICAL_STATUSES.filter((status) => {
+        if (status.key === "duplicate") {
+            return options?.includeOptionalDuplicate ?? false;
+        }
+        return true;
+    }).map((status) => status.name);
+}
+export function getCreatableCanonicalStatuses() {
+    return CANONICAL_STATUSES.filter((status) => status.creatable);
+}
+export function getPreflightRequiredCanonicalStatuses() {
+    return CANONICAL_STATUSES.filter((status) => status.key !== "duplicate" || DUPLICATE_STATUS_CONTRACT.requiredForPreflight);
+}
+export function resolveMergePathVariant(input) {
+    return input.baseBranch === input.productionBranch
+        ? "direct-production"
+        : "integration-then-production";
+}
+export function getEffectiveMergeTransitions(input) {
+    const variant = resolveMergePathVariant(input);
+    const path = CANONICAL_MERGE_PATHS.find((entry) => entry.variant === variant);
+    return path?.transitions ?? [];
+}
+export function getEffectiveCanonicalTransitions(input) {
+    return [
+        ...CANONICAL_AUTOMATION_TRANSITIONS,
+        ...CANONICAL_HUMAN_TRANSITIONS,
+        ...getEffectiveMergeTransitions(input),
+    ];
+}
+export function getCanonicalStatusKeysOnGraph() {
+    return CANONICAL_STATUSES.map((status) => status.key);
+}
+export function getDefaultCanonicalLayout() {
+    const layout = {};
+    for (const status of CANONICAL_STATUSES) {
+        layout[status.key] = { ...status.suggestedPosition };
+    }
+    return layout;
+}
+//# sourceMappingURL=canonical-product-development-workflow.js.map

package/dist/workflow/canonical-product-development-workflow.js.map

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

package/dist/workflow/canonical-workflow-gate.d.ts

@@ -0,0 +1,33 @@
+import type { HarnessConfig } from "../config/types.js";
+import type { LinearIssueSnapshot } from "../linear/client.js";
+import type { ErrorClassification } from "../types/run.js";
+import { type CanonicalValidationResult } from "./canonical-workflow-validation.js";
+export declare class CanonicalWorkflowGateError extends Error {
+    readonly errorClassification: ErrorClassification;
+    constructor(message: string, errorClassification: ErrorClassification);
+}
+export type CanonicalWorkflowGateSuccess = {
+    ok: true;
+    resolvedStatuses: CanonicalValidationResult["resolvedStatuses"];
+    informationalWarnings: CanonicalValidationResult["informationalWarnings"];
+};
+export type CanonicalWorkflowGateFailure = {
+    ok: false;
+    message: string;
+    errorClassification: ErrorClassification;
+};
+export type CanonicalWorkflowGateResult = CanonicalWorkflowGateSuccess | CanonicalWorkflowGateFailure;
+export interface AuthoritativeCanonicalWorkflowGateInput {
+    linearApiKey?: string;
+    config: HarnessConfig;
+    issue: LinearIssueSnapshot;
+    fixturePath?: string;
+    workspaceRoot?: string;
+    configPath?: string;
+    baseDir?: string;
+}
+export declare function canonicalGateFailureMessage(prefix: string, detail: string): string;
+export declare function runAuthoritativeCanonicalWorkflowGate(input: AuthoritativeCanonicalWorkflowGateInput): Promise<CanonicalWorkflowGateResult>;
+export declare function assertAuthoritativeCanonicalWorkflowGate(result: CanonicalWorkflowGateResult): asserts result is CanonicalWorkflowGateSuccess;
+export declare function classifyCanonicalGateError(error: unknown): ErrorClassification;
+//# sourceMappingURL=canonical-workflow-gate.d.ts.map

package/dist/workflow/canonical-workflow-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-workflow-gate.d.ts","sourceRoot":"","sources":["../../src/workflow/canonical-workflow-gate.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,oCAAoC,CAAC;AAE5C,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,mBAAmB;CAKtE;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,gBAAgB,EAAE,yBAAyB,CAAC,kBAAkB,CAAC,CAAC;IAChE,qBAAqB,EAAE,yBAAyB,CAAC,uBAAuB,CAAC,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,uCAAuC;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAER;AAED,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,2BAA2B,CAAC,CA2ItC;AAED,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,MAAM,IAAI,4BAA4B,CAOhD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAsC9E"}

package/dist/workflow/canonical-workflow-gate.js

@@ -0,0 +1,164 @@
+import { createLinearSetupClient, listTeamWorkflowStates, } from "../setup/linear-setup-client.js";
+import { resolveAuthoritativeLinearTeamId, resolveAuthoritativeLinearTeamIds, } from "../config/resolve-linear-team.js";
+import { runLinearAssociationGate } from "../config/linear-association-gate.js";
+import { hasLinearAssociationsInConfig } from "../config/resolve-linear-workspace.js";
+import { formatCanonicalValidationViolations, validateCanonicalLinearWorkflow, } from "./canonical-workflow-validation.js";
+export class CanonicalWorkflowGateError extends Error {
+    errorClassification;
+    constructor(message, errorClassification) {
+        super(message);
+        this.name = "CanonicalWorkflowGateError";
+        this.errorClassification = errorClassification;
+    }
+}
+export function canonicalGateFailureMessage(prefix, detail) {
+    return `${prefix}: ${detail}`;
+}
+export async function runAuthoritativeCanonicalWorkflowGate(input) {
+    if (input.fixturePath) {
+        return {
+            ok: true,
+            resolvedStatuses: {},
+            informationalWarnings: [],
+        };
+    }
+    const linearApiKey = input.linearApiKey ?? process.env.LINEAR_API_KEY ?? "";
+    if (!linearApiKey) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("linear_auth_failure", "LINEAR_API_KEY is required for authoritative canonical workflow validation"),
+            errorClassification: "linear_auth_failure",
+        };
+    }
+    if (!input.issue.teamId) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("linear_team_identity_missing", "Linear issue teamId is required for authoritative canonical workflow validation"),
+            errorClassification: "linear_team_identity_missing",
+        };
+    }
+    const associationGate = runLinearAssociationGate({
+        config: input.config,
+        teamId: input.issue.teamId,
+        projectId: input.issue.projectId,
+    });
+    if (!associationGate.ok) {
+        return {
+            ok: false,
+            message: associationGate.message,
+            errorClassification: associationGate.errorClassification,
+        };
+    }
+    const configuredTeamIds = hasLinearAssociationsInConfig(input.config)
+        ? resolveAuthoritativeLinearTeamIds(input.config)
+        : [];
+    const expectedTeamId = hasLinearAssociationsInConfig(input.config)
+        ? input.issue.teamId
+        : await resolveAuthoritativeLinearTeamId({
+            config: input.config,
+            workspaceRoot: input.workspaceRoot,
+            configPath: input.configPath,
+            baseDir: input.baseDir,
+        });
+    if (!expectedTeamId) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("linear_team_unresolved", "Configured Linear teamId is required (set linear.teamId in harness config or linearAssociations)"),
+            errorClassification: "linear_team_unresolved",
+        };
+    }
+    if (hasLinearAssociationsInConfig(input.config) &&
+        !configuredTeamIds.includes(input.issue.teamId)) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("linear_team_mismatch", `Linear team mismatch: issue team ${input.issue.teamId} is not among configured teams`),
+            errorClassification: "linear_team_mismatch",
+        };
+    }
+    if (!hasLinearAssociationsInConfig(input.config) &&
+        input.issue.teamId !== expectedTeamId) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("linear_team_mismatch", `Linear team mismatch: issue team ${input.issue.teamId} does not match configured team ${expectedTeamId}`),
+            errorClassification: "linear_team_mismatch",
+        };
+    }
+    let workflowStates;
+    try {
+        const client = createLinearSetupClient(linearApiKey);
+        workflowStates = await listTeamWorkflowStates(client, expectedTeamId);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("canonical_workflow_load_failed", detail),
+            errorClassification: "canonical_workflow_load_failed",
+        };
+    }
+    const validation = validateCanonicalLinearWorkflow({
+        workflowStates: workflowStates.map((state) => ({
+            id: state.id,
+            name: state.name,
+            category: state.type,
+        })),
+        config: input.config,
+        teamId: input.issue.teamId,
+        expectedTeamId,
+    });
+    if (!validation.valid) {
+        return {
+            ok: false,
+            message: canonicalGateFailureMessage("canonical_workflow_invalid", formatCanonicalValidationViolations(validation.violations)),
+            errorClassification: "canonical_workflow_invalid",
+        };
+    }
+    return {
+        ok: true,
+        resolvedStatuses: validation.resolvedStatuses,
+        informationalWarnings: validation.informationalWarnings,
+    };
+}
+export function assertAuthoritativeCanonicalWorkflowGate(result) {
+    if (!result.ok) {
+        throw new CanonicalWorkflowGateError(result.message, result.errorClassification);
+    }
+}
+export function classifyCanonicalGateError(error) {
+    if (error &&
+        typeof error === "object" &&
+        "errorClassification" in error &&
+        typeof error.errorClassification ===
+            "string") {
+        return error
+            .errorClassification;
+    }
+    if (error instanceof CanonicalWorkflowGateError) {
+        return error.errorClassification;
+    }
+    if (error instanceof Error) {
+        if (error.message.startsWith("canonical_workflow_invalid:")) {
+            return "canonical_workflow_invalid";
+        }
+        if (error.message.startsWith("linear_team_unresolved:")) {
+            return "linear_team_unresolved";
+        }
+        if (error.message.startsWith("linear_team_mismatch:")) {
+            return "linear_team_mismatch";
+        }
+        if (error.message.startsWith("linear_team_identity_missing:")) {
+            return "linear_team_identity_missing";
+        }
+        if (error.message.startsWith("canonical_workflow_load_failed:")) {
+            return "canonical_workflow_load_failed";
+        }
+        if (error.message.startsWith("linear_auth_failure:")) {
+            return "linear_auth_failure";
+        }
+        if (error.message.startsWith("linear_team_project_not_configured:")) {
+            return "linear_team_project_not_configured";
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=canonical-workflow-gate.js.map

package/dist/workflow/canonical-workflow-gate.js.map

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