syncpoint-ai 0.1.0

package/dist/context/context-modes.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Snapshot Dominant Context — types and mode definitions.
+ *
+ * Design principle:
+ *   snapshot-only means agent working-context only, not protocol-only.
+ *
+ * Three layers:
+ *   1. Protocol Gate   — hard collaboration rules (pinned, contract, claims, gates, review/wake)
+ *   2. Snapshot Reality — agent's current task working memory
+ *   3. Validation Notes — staleness, evidence coverage, missing proof
+ */
+import { z } from "zod";
+export declare const ContextMode: z.ZodEnum<["snapshot-first", "snapshot-only", "snapshot-locked"]>;
+export type ContextMode = z.infer<typeof ContextMode>;
+export declare const DEFAULT_CONTEXT_MODE: ContextMode;
+export declare const ProtocolRuleSchema: z.ZodObject<{
+    source: z.ZodEnum<["pinned-memory", "peer-contract", "resource-claim", "sync-gate", "checkpoint-review", "review", "wake", "assignment", "projection"]>;
+    severity: z.ZodEnum<["hard", "soft", "info"]>;
+    summary: z.ZodString;
+    entityId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    severity: "info" | "hard" | "soft";
+    source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+    entityId?: string | undefined;
+}, {
+    summary: string;
+    severity: "info" | "hard" | "soft";
+    source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+    entityId?: string | undefined;
+}>;
+export type ProtocolRule = z.infer<typeof ProtocolRuleSchema>;
+export declare const ProtocolGateSummarySchema: z.ZodObject<{
+    /** All active protocol rules for this agent+task */
+    rules: z.ZodArray<z.ZodObject<{
+        source: z.ZodEnum<["pinned-memory", "peer-contract", "resource-claim", "sync-gate", "checkpoint-review", "review", "wake", "assignment", "projection"]>;
+        severity: z.ZodEnum<["hard", "soft", "info"]>;
+        summary: z.ZodString;
+        entityId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        summary: string;
+        severity: "info" | "hard" | "soft";
+        source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+        entityId?: string | undefined;
+    }, {
+        summary: string;
+        severity: "info" | "hard" | "soft";
+        source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+        entityId?: string | undefined;
+    }>, "many">;
+    /** True if any hard rule is violated / unresolved */
+    blocked: z.ZodBoolean;
+    /** Hard-blocking rule summaries */
+    hardBlockers: z.ZodArray<z.ZodString, "many">;
+    /** Counts by source */
+    counts: z.ZodObject<{
+        pinnedRules: z.ZodNumber;
+        contractConstraints: z.ZodNumber;
+        resourceClaims: z.ZodNumber;
+        activeGates: z.ZodNumber;
+        activeTransactions: z.ZodNumber;
+        pendingReviews: z.ZodNumber;
+        pendingWakes: z.ZodNumber;
+        projectionRules: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pinnedRules: number;
+        contractConstraints: number;
+        resourceClaims: number;
+        activeGates: number;
+        activeTransactions: number;
+        pendingReviews: number;
+        pendingWakes: number;
+        projectionRules: number;
+    }, {
+        pinnedRules: number;
+        contractConstraints: number;
+        resourceClaims: number;
+        activeGates: number;
+        activeTransactions: number;
+        pendingReviews: number;
+        pendingWakes: number;
+        projectionRules?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    blocked: boolean;
+    rules: {
+        summary: string;
+        severity: "info" | "hard" | "soft";
+        source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+        entityId?: string | undefined;
+    }[];
+    hardBlockers: string[];
+    counts: {
+        pinnedRules: number;
+        contractConstraints: number;
+        resourceClaims: number;
+        activeGates: number;
+        activeTransactions: number;
+        pendingReviews: number;
+        pendingWakes: number;
+        projectionRules: number;
+    };
+}, {
+    blocked: boolean;
+    rules: {
+        summary: string;
+        severity: "info" | "hard" | "soft";
+        source: "peer-contract" | "review" | "pinned-memory" | "resource-claim" | "sync-gate" | "checkpoint-review" | "wake" | "assignment" | "projection";
+        entityId?: string | undefined;
+    }[];
+    hardBlockers: string[];
+    counts: {
+        pinnedRules: number;
+        contractConstraints: number;
+        resourceClaims: number;
+        activeGates: number;
+        activeTransactions: number;
+        pendingReviews: number;
+        pendingWakes: number;
+        projectionRules?: number | undefined;
+    };
+}>;
+export type ProtocolGateSummary = z.infer<typeof ProtocolGateSummarySchema>;
+export declare const SnapshotValidationSchema: z.ZodObject<{
+    /** Overall: is the snapshot valid for use? */
+    valid: z.ZodBoolean;
+    /** Is the snapshot stale relative to latest checkpoint? */
+    stale: z.ZodBoolean;
+    staleReason: z.ZodNullable<z.ZodString>;
+    /** Does the snapshot belong to the correct task+agent? */
+    scopeMatch: z.ZodBoolean;
+    /** Are there unresolved blockers in the snapshot? */
+    hasBlockers: z.ZodBoolean;
+    /** Evidence: does a checkpoint exist to back the snapshot? */
+    hasEvidence: z.ZodBoolean;
+    /** Needs sync flag from checkpoint */
+    needsSync: z.ZodBoolean;
+    /** Human-readable validation notes */
+    notes: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    valid: boolean;
+    stale: boolean;
+    staleReason: string | null;
+    scopeMatch: boolean;
+    hasBlockers: boolean;
+    hasEvidence: boolean;
+    needsSync: boolean;
+    notes: string[];
+}, {
+    valid: boolean;
+    stale: boolean;
+    staleReason: string | null;
+    scopeMatch: boolean;
+    hasBlockers: boolean;
+    hasEvidence: boolean;
+    needsSync: boolean;
+    notes: string[];
+}>;
+export type SnapshotValidation = z.infer<typeof SnapshotValidationSchema>;
+export declare const SnapshotExtendedFieldsSchema: z.ZodObject<{
+    intentScope: z.ZodDefault<z.ZodString>;
+    nonGoals: z.ZodDefault<z.ZodString>;
+    verifiedFacts: z.ZodDefault<z.ZodString>;
+    unverifiedClaims: z.ZodDefault<z.ZodString>;
+    evidenceRefs: z.ZodDefault<z.ZodString>;
+    activeConstraints: z.ZodDefault<z.ZodString>;
+    doNotTouch: z.ZodDefault<z.ZodString>;
+    handoffInstructions: z.ZodDefault<z.ZodString>;
+    validationStatus: z.ZodDefault<z.ZodString>;
+    staleReason: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    intentScope: string;
+    nonGoals: string;
+    verifiedFacts: string;
+    unverifiedClaims: string;
+    evidenceRefs: string;
+    activeConstraints: string;
+    doNotTouch: string;
+    handoffInstructions: string;
+    staleReason: string;
+    validationStatus: string;
+}, {
+    intentScope?: string | undefined;
+    nonGoals?: string | undefined;
+    verifiedFacts?: string | undefined;
+    unverifiedClaims?: string | undefined;
+    evidenceRefs?: string | undefined;
+    activeConstraints?: string | undefined;
+    doNotTouch?: string | undefined;
+    handoffInstructions?: string | undefined;
+    staleReason?: string | undefined;
+    validationStatus?: string | undefined;
+}>;
+export type SnapshotExtendedFields = z.infer<typeof SnapshotExtendedFieldsSchema>;
+//# sourceMappingURL=context-modes.d.ts.map

package/dist/context/context-modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-modes.d.ts","sourceRoot":"","sources":["../../_build/src/context/context-modes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,WAAW,mEAItB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,oBAAoB,EAAE,WAA8B,CAAC;AAIlE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,yBAAyB;IACpC,oDAAoD;;;;;;;;;;;;;;;;;IAEpD,qDAAqD;;IAErD,mCAAmC;;IAEnC,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvB,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,eAAO,MAAM,wBAAwB;IACnC,8CAA8C;;IAE9C,2DAA2D;;;IAG3D,0DAA0D;;IAE1D,qDAAqD;;IAErD,8DAA8D;;IAE9D,sCAAsC;;IAEtC,sCAAsC;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/context/context-modes.js

@@ -0,0 +1,79 @@
+/**
+ * Snapshot Dominant Context — types and mode definitions.
+ *
+ * Design principle:
+ *   snapshot-only means agent working-context only, not protocol-only.
+ *
+ * Three layers:
+ *   1. Protocol Gate   — hard collaboration rules (pinned, contract, claims, gates, review/wake)
+ *   2. Snapshot Reality — agent's current task working memory
+ *   3. Validation Notes — staleness, evidence coverage, missing proof
+ */
+import { z } from "zod";
+// ── Context Mode ─────────────────────────────────────
+export const ContextMode = z.enum([
+    "snapshot-first", // snapshot primary, validation notes visible, full prompt
+    "snapshot-only", // snapshot + protocol gate summary only, no raw checkpoint/project memory
+    "snapshot-locked", // validated snapshot + protocol gate only, hard-block on any gate failure
+]);
+export const DEFAULT_CONTEXT_MODE = "snapshot-first";
+// ── Protocol Gate Summary ────────────────────────────
+export const ProtocolRuleSchema = z.object({
+    source: z.enum(["pinned-memory", "peer-contract", "resource-claim", "sync-gate", "checkpoint-review", "review", "wake", "assignment", "projection"]),
+    severity: z.enum(["hard", "soft", "info"]),
+    summary: z.string(),
+    entityId: z.string().optional(),
+});
+export const ProtocolGateSummarySchema = z.object({
+    /** All active protocol rules for this agent+task */
+    rules: z.array(ProtocolRuleSchema),
+    /** True if any hard rule is violated / unresolved */
+    blocked: z.boolean(),
+    /** Hard-blocking rule summaries */
+    hardBlockers: z.array(z.string()),
+    /** Counts by source */
+    counts: z.object({
+        pinnedRules: z.number(),
+        contractConstraints: z.number(),
+        resourceClaims: z.number(),
+        activeGates: z.number(),
+        activeTransactions: z.number(),
+        pendingReviews: z.number(),
+        pendingWakes: z.number(),
+        projectionRules: z.number().default(0),
+    }),
+});
+// ── Snapshot Validation ──────────────────────────────
+export const SnapshotValidationSchema = z.object({
+    /** Overall: is the snapshot valid for use? */
+    valid: z.boolean(),
+    /** Is the snapshot stale relative to latest checkpoint? */
+    stale: z.boolean(),
+    staleReason: z.string().nullable(),
+    /** Does the snapshot belong to the correct task+agent? */
+    scopeMatch: z.boolean(),
+    /** Are there unresolved blockers in the snapshot? */
+    hasBlockers: z.boolean(),
+    /** Evidence: does a checkpoint exist to back the snapshot? */
+    hasEvidence: z.boolean(),
+    /** Needs sync flag from checkpoint */
+    needsSync: z.boolean(),
+    /** Human-readable validation notes */
+    notes: z.array(z.string()),
+});
+// ── Extended Snapshot Fields (additive) ──────────────
+// These are optional new fields that enrich the snapshot.
+// Existing snapshots without these fields still work (defaults to "").
+export const SnapshotExtendedFieldsSchema = z.object({
+    intentScope: z.string().default(""),
+    nonGoals: z.string().default(""),
+    verifiedFacts: z.string().default(""),
+    unverifiedClaims: z.string().default(""),
+    evidenceRefs: z.string().default(""),
+    activeConstraints: z.string().default(""),
+    doNotTouch: z.string().default(""),
+    handoffInstructions: z.string().default(""),
+    validationStatus: z.string().default(""),
+    staleReason: z.string().default(""),
+});
+//# sourceMappingURL=context-modes.js.map

package/dist/context/context-modes.js.map

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

package/dist/context/context-policy.d.ts

@@ -0,0 +1,364 @@
+/**
+ * Context Policy — role-aware context preparation layer.
+ *
+ * Defines what context each role/intent needs before starting work,
+ * and whether missing context should hard-block, soft-warn, or pass through.
+ */
+import { z } from "zod";
+export declare const ContextIntent: z.ZodEnum<["execute", "resume", "handoff-receive", "review", "architect-plan", "project-onboard", "memory-review"]>;
+export type ContextIntent = z.infer<typeof ContextIntent>;
+export declare const ContextRole: z.ZodEnum<["architect", "executor", "reviewer", "peer", "handoff-receiver", "observer"]>;
+export type ContextRole = z.infer<typeof ContextRole>;
+export declare const ContextGateMode: z.ZodEnum<["hard", "soft", "none"]>;
+export type ContextGateMode = z.infer<typeof ContextGateMode>;
+export declare const ContextSection: z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>;
+export type ContextSection = z.infer<typeof ContextSection>;
+export declare const ContextPolicySchema: z.ZodObject<{
+    intent: z.ZodEnum<["execute", "resume", "handoff-receive", "review", "architect-plan", "project-onboard", "memory-review"]>;
+    gateMode: z.ZodEnum<["hard", "soft", "none"]>;
+    requiredSections: z.ZodArray<z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>, "many">;
+    includeSections: z.ZodArray<z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>, "many">;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    intent: "review" | "resume" | "execute" | "handoff-receive" | "architect-plan" | "project-onboard" | "memory-review";
+    gateMode: "hard" | "soft" | "none";
+    requiredSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+    includeSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+}, {
+    description: string;
+    intent: "review" | "resume" | "execute" | "handoff-receive" | "architect-plan" | "project-onboard" | "memory-review";
+    gateMode: "hard" | "soft" | "none";
+    requiredSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+    includeSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+}>;
+export type ContextPolicy = z.infer<typeof ContextPolicySchema>;
+export declare const ContextPolicyCheckSchema: z.ZodObject<{
+    section: z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>;
+    present: z.ZodBoolean;
+    required: z.ZodBoolean;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+    present: boolean;
+    required: boolean;
+}, {
+    message: string;
+    section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+    present: boolean;
+    required: boolean;
+}>;
+export type ContextPolicyCheck = z.infer<typeof ContextPolicyCheckSchema>;
+export declare const PreparedContextSchema: z.ZodObject<{
+    intent: z.ZodEnum<["execute", "resume", "handoff-receive", "review", "architect-plan", "project-onboard", "memory-review"]>;
+    role: z.ZodEnum<["architect", "executor", "reviewer", "peer", "handoff-receiver", "observer"]>;
+    gateMode: z.ZodEnum<["hard", "soft", "none"]>;
+    /** Is the context ready to proceed? (hard gate: false blocks; soft gate: false warns) */
+    ready: z.ZodBoolean;
+    /** Which required sections are missing */
+    missingSections: z.ZodArray<z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>, "many">;
+    /** Per-section check results */
+    checks: z.ZodArray<z.ZodObject<{
+        section: z.ZodEnum<["task", "agent", "latest-snapshot", "latest-checkpoint", "approved-contract", "handoff-context", "approved-project-memory", "pinned-memory", "task-list", "agent-list", "draft-memories", "deprecated-memories", "open-decisions", "risks"]>;
+        present: z.ZodBoolean;
+        required: z.ZodBoolean;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+        present: boolean;
+        required: boolean;
+    }, {
+        message: string;
+        section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+        present: boolean;
+        required: boolean;
+    }>, "many">;
+    /** Human-readable warnings */
+    warnings: z.ZodArray<z.ZodString, "many">;
+    /** Task info (null if task not required or not found) */
+    task: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodString;
+        ownerAgentId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }, {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }>>;
+    /** Agent info (null if agent not required or not found) */
+    agent: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        role: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        role: string;
+    }, {
+        id: string;
+        name: string;
+        role: string;
+    }>>;
+    /** Resume context (present for execute/resume/handoff-receive) */
+    resumeContext: z.ZodNullable<z.ZodAny>;
+    /** Latest handoff context (present for handoff-receive when available) */
+    handoffContext: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        fromAgentId: z.ZodString;
+        toAgentId: z.ZodString;
+        taskId: z.ZodString;
+        contextSummary: z.ZodString;
+        status: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        taskId: string;
+        fromAgentId: string;
+        toAgentId: string;
+        contextSummary: string;
+    }, {
+        status: string;
+        id: string;
+        taskId: string;
+        fromAgentId: string;
+        toAgentId: string;
+        contextSummary: string;
+    }>>>;
+    /** Approved project memories */
+    projectMemories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }, {
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }>, "many">;
+    /** Draft project memories (for memory-review intent) */
+    draftMemories: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        category: z.ZodString;
+        title: z.ZodString;
+        content: z.ZodString;
+        status: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }, {
+        status: string;
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }>, "many">>;
+    /** All tasks (for architect-plan, project-onboard) */
+    taskList: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        status: z.ZodString;
+        ownerAgentId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }, {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }>, "many">>;
+    /** All agents (for project-onboard) */
+    agentList: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        role: z.ZodString;
+        status: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        name: string;
+        role: string;
+    }, {
+        status: string;
+        id: string;
+        name: string;
+        role: string;
+    }>, "many">>;
+    /** Formatted prompt text for the given intent */
+    prompt: z.ZodString;
+    /** Suggested next actions for the agent */
+    suggestedNextActions: z.ZodArray<z.ZodString, "many">;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    warnings: string[];
+    intent: "review" | "resume" | "execute" | "handoff-receive" | "architect-plan" | "project-onboard" | "memory-review";
+    agent: {
+        id: string;
+        name: string;
+        role: string;
+    } | null;
+    task: {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    } | null;
+    ready: boolean;
+    checks: {
+        message: string;
+        section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+        present: boolean;
+        required: boolean;
+    }[];
+    role: "architect" | "executor" | "reviewer" | "peer" | "handoff-receiver" | "observer";
+    projectMemories: {
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }[];
+    generatedAt: string;
+    gateMode: "hard" | "soft" | "none";
+    missingSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+    handoffContext: {
+        status: string;
+        id: string;
+        taskId: string;
+        fromAgentId: string;
+        toAgentId: string;
+        contextSummary: string;
+    } | null;
+    draftMemories: {
+        status: string;
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }[];
+    taskList: {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }[];
+    agentList: {
+        status: string;
+        id: string;
+        name: string;
+        role: string;
+    }[];
+    prompt: string;
+    suggestedNextActions: string[];
+    resumeContext?: any;
+}, {
+    warnings: string[];
+    intent: "review" | "resume" | "execute" | "handoff-receive" | "architect-plan" | "project-onboard" | "memory-review";
+    agent: {
+        id: string;
+        name: string;
+        role: string;
+    } | null;
+    task: {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    } | null;
+    ready: boolean;
+    checks: {
+        message: string;
+        section: "agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions";
+        present: boolean;
+        required: boolean;
+    }[];
+    role: "architect" | "executor" | "reviewer" | "peer" | "handoff-receiver" | "observer";
+    projectMemories: {
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }[];
+    generatedAt: string;
+    gateMode: "hard" | "soft" | "none";
+    missingSections: ("agent" | "task" | "risks" | "latest-snapshot" | "latest-checkpoint" | "approved-contract" | "handoff-context" | "approved-project-memory" | "pinned-memory" | "task-list" | "agent-list" | "draft-memories" | "deprecated-memories" | "open-decisions")[];
+    prompt: string;
+    suggestedNextActions: string[];
+    resumeContext?: any;
+    handoffContext?: {
+        status: string;
+        id: string;
+        taskId: string;
+        fromAgentId: string;
+        toAgentId: string;
+        contextSummary: string;
+    } | null | undefined;
+    draftMemories?: {
+        status: string;
+        id: string;
+        title: string;
+        content: string;
+        category: string;
+    }[] | undefined;
+    taskList?: {
+        status: string;
+        id: string;
+        title: string;
+        ownerAgentId: string | null;
+    }[] | undefined;
+    agentList?: {
+        status: string;
+        id: string;
+        name: string;
+        role: string;
+    }[] | undefined;
+}>;
+export type PreparedContext = z.infer<typeof PreparedContextSchema>;
+export declare const CONTEXT_POLICIES: Record<ContextIntent, ContextPolicy>;
+/**
+ * Get the context policy for an intent.
+ */
+export declare function getContextPolicy(intent: ContextIntent): ContextPolicy;
+export type RelationshipModeStr = "manager-delegate" | "peer-contract" | "handoff-resume";
+/**
+ * Mode-specific additions to context policies.
+ * Each entry lists extra required/included sections to merge with the base policy.
+ */
+export declare const MODE_CONTEXT_OVERRIDES: Record<RelationshipModeStr, Partial<Record<ContextIntent, {
+    addRequired?: ContextSection[];
+    addInclude?: ContextSection[];
+    gateMode?: ContextGateMode;
+}>>>;
+/**
+ * Get context policy for an intent, adjusted for the session's relationship mode.
+ * Merges base policy with mode-specific overrides.
+ */
+export declare function getContextPolicyForMode(intent: ContextIntent, mode?: RelationshipModeStr): ContextPolicy;
+/**
+ * List all supported intents.
+ */
+export declare function listContextIntents(): ContextIntent[];
+/**
+ * List all supported roles.
+ */
+export declare function listContextRoles(): ContextRole[];
+//# sourceMappingURL=context-policy.d.ts.map

package/dist/context/context-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-policy.d.ts","sourceRoot":"","sources":["../../_build/src/context/context-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,aAAa,qHAQxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,WAAW,0FAOtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,eAAe,qCAAmC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAI9D,eAAO,MAAM,cAAc,yPAezB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAI5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,qBAAqB;;;;IAKhC,yFAAyF;;IAGzF,0CAA0C;;IAG1C,gCAAgC;;;;;;;;;;;;;;;;;IAGhC,8BAA8B;;IAG9B,yDAAyD;;;;;;;;;;;;;;;;;IAQzD,2DAA2D;;;;;;;;;;;;;;IAO3D,kEAAkE;;IAGlE,0EAA0E;;;;;;;;;;;;;;;;;;;;;;;IAU1E,gCAAgC;;;;;;;;;;;;;;;;;IAQhC,wDAAwD;;;;;;;;;;;;;;;;;;;;IASxD,sDAAsD;;;;;;;;;;;;;;;;;IAQtD,uCAAuC;;;;;;;;;;;;;;;;;IAQvC,iDAAiD;;IAGjD,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3C,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,aAAa,CAkDjE,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAErE;AAID,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE;IAC7F,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC,CAAC,CA0BF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,mBAAmB,GACzB,aAAa,CAsBf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,aAAa,EAAE,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD"}