@kb-labs/steward-contracts 0.1.0

package/README.md

@@ -0,0 +1,5 @@
+# @kb-labs/steward-contracts
+
+> Part of [KB Labs](https://github.com/kb-labs-team/kb-labs) ecosystem.
+
+Domain types and input schemas for the steward personal PM/CRM plugin.

package/dist/index.d.ts

@@ -0,0 +1,469 @@
+import { z } from 'zod';
+
+/**
+ * System fields every stored document carries. Structurally compatible with
+ * the platform's `BaseDocument` (`@kb-labs/core-platform`) without importing
+ * it — contracts stays dependency-free beyond zod.
+ */
+interface Timestamped {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+}
+/** The set of entities an `Event` can be attached to. */
+type EventSubjectType = 'project' | 'person' | 'commitment' | 'company' | 'resource';
+
+type ProjectStatus = 'active' | 'paused' | 'archived';
+interface Project extends Timestamped {
+    name: string;
+    status: ProjectStatus;
+    description?: string;
+}
+/**
+ * Universal attachment on a project — repo, dev/prod stand, dashboard, doc...
+ * `type` is a free string on purpose (see ADR-0001 §Resource).
+ * `url` and `content` may both be set, or either alone.
+ */
+interface Resource extends Timestamped {
+    projectId: string;
+    type: string;
+    label: string;
+    url?: string;
+    content?: string;
+}
+
+type ContactChannel = 'telegram' | 'email' | 'phone' | 'other';
+interface Contact {
+    channel: ContactChannel;
+    value: string;
+    /** Lower = preferred. Used to pick the primary channel when several exist. */
+    priority: number;
+}
+/** Global contact — not owned by any single project. */
+interface Person extends Timestamped {
+    name: string;
+    contacts: Contact[];
+    companyId?: string;
+    /** Competencies reachable from any project — see ADR-0001 §Routing. */
+    globalTopics: string[];
+}
+/**
+ * Thin entity: `{id, name}` only in MVP. The link (`Person.companyId`) is
+ * fixed now precisely so company-level features can grow later without a
+ * migration — see ADR-0001 §"Миграционная политика".
+ */
+interface Company extends Timestamped {
+    name: string;
+}
+/** Person ↔ Project link. `priority` doubles as the whoToContact fallback order. */
+interface ProjectMember extends Timestamped {
+    personId: string;
+    projectId: string;
+    role: string;
+    /** Competencies in the context of this project — augments `globalTopics`. */
+    topics?: string[];
+    /** Lower = contacted first when multiple members match a topic. */
+    priority: number;
+}
+
+type CommitmentStatus = 'open' | 'done' | 'dropped';
+/**
+ * A promise to a person with a soft deadline — distinct from a formal task.
+ * See ADR-0001 §Commitment.
+ */
+interface Commitment extends Timestamped {
+    text: string;
+    personId?: string;
+    projectId?: string;
+    status: CommitmentStatus;
+    remindAt?: number;
+    /** Set when snoozed; review ignores the commitment until this passes. */
+    snoozedUntil?: number;
+    /** Days without update after which an open commitment is considered stale. */
+    staleAfterDays: number;
+}
+
+type EventKind = 'note' | 'project.created' | 'project.status_changed' | 'commitment.created' | 'commitment.done' | 'commitment.dropped' | 'commitment.rescheduled' | 'person.merged' | 'review.generated' | 'integrity.checked' | 'export.completed' | 'backfill.imported';
+declare const SEMANTIC_EVENT_KINDS: readonly EventKind[];
+declare const DERIVED_EVENT_KINDS: readonly EventKind[];
+declare const TRACE_EVENT_KINDS: readonly EventKind[];
+/**
+ * Append-only history log — the thing that makes the memory "infinite".
+ * `subjectType`/`subjectId` are a polymorphic reference on purpose (flat,
+ * not nested — `DocumentFilter` only supports top-level keys) so new
+ * entities never require a schema change here. See ADR-0001 §Event.
+ */
+interface Event extends Timestamped {
+    at: number;
+    kind: EventKind;
+    subjectType: EventSubjectType;
+    subjectId: string;
+    reason?: string;
+    text?: string;
+    meta?: Record<string, unknown>;
+}
+
+/**
+ * Topic dictionary with aliases. Normalized on write, not on read — a
+ * deterministic lookup over an uncontrolled vocabulary is worse than a
+ * fuzzy one (ADR-0001 §Routing). Entries are created deliberately.
+ */
+interface Topic extends Timestamped {
+    name: string;
+    aliases: string[];
+}
+
+/**
+ * Typed but not implemented in MVP — deferred as a whole new collection,
+ * nothing to migrate later. See ADR-0001 §"Миграционная политика".
+ */
+type TaskStatus = 'open' | 'done';
+interface Task extends Timestamped {
+    title: string;
+    projectId?: string;
+    status: TaskStatus;
+    dueDate?: number;
+}
+
+/**
+ * Collection names — must match what `core` passes to `ensureCollection`.
+ * Actual storage names are namespaced by the platform as `steward__<name>`.
+ */
+declare const COLLECTIONS: {
+    readonly projects: "projects";
+    readonly resources: "resources";
+    readonly people: "people";
+    readonly companies: "companies";
+    readonly projectMembers: "project_members";
+    readonly commitments: "commitments";
+    readonly events: "events";
+    readonly topics: "topics";
+};
+/** Default commitment staleness threshold — see ADR-0001 §Commitment. */
+declare const DEFAULT_STALE_AFTER_DAYS = 14;
+/** Event retention classes — see ADR-0001 §"Ретеншен событий". `semantic` is never deleted. */
+declare const EVENT_RETENTION_MAX_AGE_MS: Record<'derived' | 'trace', number>;
+
+/**
+ * Zod schemas for everything that crosses the CLI/MCP boundary — command
+ * inputs and the results agents read back. Domain models in `types/` stay
+ * plain interfaces (see ADR-0001 §"Разделение core/entry").
+ */
+
+declare const AddProjectInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<["active", "paused", "archived"]>>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    status: "active" | "paused" | "archived";
+    description?: string | undefined;
+}, {
+    name: string;
+    status?: "active" | "paused" | "archived" | undefined;
+    description?: string | undefined;
+}>;
+type AddProjectInput = z.infer<typeof AddProjectInputSchema>;
+declare const UpdateProjectInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "archived"]>>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    status?: "active" | "paused" | "archived" | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    status?: "active" | "paused" | "archived" | undefined;
+    description?: string | undefined;
+}>;
+type UpdateProjectInput = z.infer<typeof UpdateProjectInputSchema>;
+declare const ListProjectsInputSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "archived"]>>;
+}, "strip", z.ZodTypeAny, {
+    status?: "active" | "paused" | "archived" | undefined;
+}, {
+    status?: "active" | "paused" | "archived" | undefined;
+}>;
+type ListProjectsInput = z.infer<typeof ListProjectsInputSchema>;
+declare const AddResourceInputSchema: z.ZodEffects<z.ZodObject<{
+    projectId: z.ZodString;
+    type: z.ZodString;
+    label: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    projectId: string;
+    label: string;
+    url?: string | undefined;
+    content?: string | undefined;
+}, {
+    type: string;
+    projectId: string;
+    label: string;
+    url?: string | undefined;
+    content?: string | undefined;
+}>, {
+    type: string;
+    projectId: string;
+    label: string;
+    url?: string | undefined;
+    content?: string | undefined;
+}, {
+    type: string;
+    projectId: string;
+    label: string;
+    url?: string | undefined;
+    content?: string | undefined;
+}>;
+type AddResourceInput = z.infer<typeof AddResourceInputSchema>;
+declare const ContactInputSchema: z.ZodObject<{
+    channel: z.ZodEnum<["telegram", "email", "phone", "other"]>;
+    value: z.ZodString;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    channel: "telegram" | "email" | "phone" | "other";
+    priority: number;
+}, {
+    value: string;
+    channel: "telegram" | "email" | "phone" | "other";
+    priority?: number | undefined;
+}>;
+declare const AddPersonInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    contacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        channel: z.ZodEnum<["telegram", "email", "phone", "other"]>;
+        value: z.ZodString;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority: number;
+    }, {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority?: number | undefined;
+    }>, "many">>;
+    companyId: z.ZodOptional<z.ZodString>;
+    globalTopics: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    contacts: {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority: number;
+    }[];
+    globalTopics: string[];
+    companyId?: string | undefined;
+}, {
+    name: string;
+    contacts?: {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority?: number | undefined;
+    }[] | undefined;
+    companyId?: string | undefined;
+    globalTopics?: string[] | undefined;
+}>;
+type AddPersonInput = z.infer<typeof AddPersonInputSchema>;
+declare const UpdatePersonInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    contacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        channel: z.ZodEnum<["telegram", "email", "phone", "other"]>;
+        value: z.ZodString;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority: number;
+    }, {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority?: number | undefined;
+    }>, "many">>;
+    companyId: z.ZodOptional<z.ZodString>;
+    globalTopics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    contacts?: {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority: number;
+    }[] | undefined;
+    companyId?: string | undefined;
+    globalTopics?: string[] | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    contacts?: {
+        value: string;
+        channel: "telegram" | "email" | "phone" | "other";
+        priority?: number | undefined;
+    }[] | undefined;
+    companyId?: string | undefined;
+    globalTopics?: string[] | undefined;
+}>;
+type UpdatePersonInput = z.infer<typeof UpdatePersonInputSchema>;
+declare const AddCompanyInputSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+type AddCompanyInput = z.infer<typeof AddCompanyInputSchema>;
+declare const AddMemberInputSchema: z.ZodObject<{
+    personId: z.ZodString;
+    projectId: z.ZodString;
+    role: z.ZodString;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    priority: number;
+    personId: string;
+    role: string;
+    topics?: string[] | undefined;
+}, {
+    projectId: string;
+    personId: string;
+    role: string;
+    topics?: string[] | undefined;
+    priority?: number | undefined;
+}>;
+type AddMemberInput = z.infer<typeof AddMemberInputSchema>;
+declare const WhoToContactInputSchema: z.ZodObject<{
+    topic: z.ZodString;
+    projectId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    projectId?: string | undefined;
+}, {
+    topic: string;
+    projectId?: string | undefined;
+}>;
+type WhoToContactInput = z.infer<typeof WhoToContactInputSchema>;
+declare const AddCommitmentInputSchema: z.ZodObject<{
+    text: z.ZodString;
+    personId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    remindAt: z.ZodOptional<z.ZodNumber>;
+    staleAfterDays: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    staleAfterDays: number;
+    projectId?: string | undefined;
+    personId?: string | undefined;
+    remindAt?: number | undefined;
+}, {
+    text: string;
+    projectId?: string | undefined;
+    personId?: string | undefined;
+    remindAt?: number | undefined;
+    staleAfterDays?: number | undefined;
+}>;
+type AddCommitmentInput = z.infer<typeof AddCommitmentInputSchema>;
+declare const ListCommitmentsInputSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<["open", "done", "dropped"]>>;
+    projectId: z.ZodOptional<z.ZodString>;
+    staleOnly: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    staleOnly: boolean;
+    status?: "open" | "done" | "dropped" | undefined;
+    projectId?: string | undefined;
+}, {
+    status?: "open" | "done" | "dropped" | undefined;
+    projectId?: string | undefined;
+    staleOnly?: boolean | undefined;
+}>;
+type ListCommitmentsInput = z.infer<typeof ListCommitmentsInputSchema>;
+declare const CommitmentDoneInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+type CommitmentDoneInput = z.infer<typeof CommitmentDoneInputSchema>;
+declare const CommitmentDropInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    reason: string;
+}, {
+    id: string;
+    reason: string;
+}>;
+type CommitmentDropInput = z.infer<typeof CommitmentDropInputSchema>;
+declare const CommitmentSnoozeInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    until: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    until: number;
+    reason?: string | undefined;
+}, {
+    id: string;
+    until: number;
+    reason?: string | undefined;
+}>;
+type CommitmentSnoozeInput = z.infer<typeof CommitmentSnoozeInputSchema>;
+declare const AddEventInputSchema: z.ZodObject<{
+    subjectType: z.ZodEnum<["project", "person", "commitment", "company", "resource"]>;
+    subjectId: z.ZodString;
+    kind: z.ZodDefault<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    subjectType: "project" | "person" | "commitment" | "company" | "resource";
+    subjectId: string;
+    kind: string;
+    text?: string | undefined;
+    reason?: string | undefined;
+    meta?: Record<string, unknown> | undefined;
+}, {
+    subjectType: "project" | "person" | "commitment" | "company" | "resource";
+    subjectId: string;
+    text?: string | undefined;
+    reason?: string | undefined;
+    kind?: string | undefined;
+    meta?: Record<string, unknown> | undefined;
+}>;
+type AddEventInput = z.infer<typeof AddEventInputSchema>;
+declare const ListEventsInputSchema: z.ZodObject<{
+    subjectType: z.ZodOptional<z.ZodEnum<["project", "person", "commitment", "company", "resource"]>>;
+    subjectId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    subjectType?: "project" | "person" | "commitment" | "company" | "resource" | undefined;
+    subjectId?: string | undefined;
+    kind?: string | undefined;
+    since?: number | undefined;
+}, {
+    subjectType?: "project" | "person" | "commitment" | "company" | "resource" | undefined;
+    subjectId?: string | undefined;
+    kind?: string | undefined;
+    since?: number | undefined;
+}>;
+type ListEventsInput = z.infer<typeof ListEventsInputSchema>;
+declare const AddTopicInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    aliases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    aliases: string[];
+}, {
+    name: string;
+    aliases?: string[] | undefined;
+}>;
+type AddTopicInput = z.infer<typeof AddTopicInputSchema>;
+
+export { type AddCommitmentInput, AddCommitmentInputSchema, type AddCompanyInput, AddCompanyInputSchema, type AddEventInput, AddEventInputSchema, type AddMemberInput, AddMemberInputSchema, type AddPersonInput, AddPersonInputSchema, type AddProjectInput, AddProjectInputSchema, type AddResourceInput, AddResourceInputSchema, type AddTopicInput, AddTopicInputSchema, COLLECTIONS, type Commitment, type CommitmentDoneInput, CommitmentDoneInputSchema, type CommitmentDropInput, CommitmentDropInputSchema, type CommitmentSnoozeInput, CommitmentSnoozeInputSchema, type CommitmentStatus, type Company, type Contact, type ContactChannel, ContactInputSchema, DEFAULT_STALE_AFTER_DAYS, DERIVED_EVENT_KINDS, EVENT_RETENTION_MAX_AGE_MS, type Event, type EventKind, type EventSubjectType, type ListCommitmentsInput, ListCommitmentsInputSchema, type ListEventsInput, ListEventsInputSchema, type ListProjectsInput, ListProjectsInputSchema, type Person, type Project, type ProjectMember, type ProjectStatus, type Resource, SEMANTIC_EVENT_KINDS, TRACE_EVENT_KINDS, type Task, type TaskStatus, type Timestamped, type Topic, type UpdatePersonInput, UpdatePersonInputSchema, type UpdateProjectInput, UpdateProjectInputSchema, type WhoToContactInput, WhoToContactInputSchema };

package/dist/index.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+
+// src/types/event.ts
+var SEMANTIC_EVENT_KINDS = [
+  "note",
+  "project.created",
+  "project.status_changed",
+  "commitment.created",
+  "commitment.done",
+  "commitment.dropped",
+  "commitment.rescheduled",
+  "person.merged"
+];
+var DERIVED_EVENT_KINDS = [
+  "review.generated",
+  "integrity.checked",
+  "export.completed"
+];
+var TRACE_EVENT_KINDS = ["backfill.imported"];
+
+// src/constants.ts
+var COLLECTIONS = {
+  projects: "projects",
+  resources: "resources",
+  people: "people",
+  companies: "companies",
+  projectMembers: "project_members",
+  commitments: "commitments",
+  events: "events",
+  topics: "topics"
+};
+var DEFAULT_STALE_AFTER_DAYS = 14;
+var EVENT_RETENTION_MAX_AGE_MS = {
+  derived: 90 * 24 * 60 * 60 * 1e3,
+  trace: 14 * 24 * 60 * 60 * 1e3
+};
+var AddProjectInputSchema = z.object({
+  name: z.string().min(1),
+  status: z.enum(["active", "paused", "archived"]).default("active"),
+  description: z.string().optional()
+});
+var UpdateProjectInputSchema = z.object({
+  id: z.string().min(1),
+  status: z.enum(["active", "paused", "archived"]).optional(),
+  description: z.string().optional()
+});
+var ListProjectsInputSchema = z.object({
+  status: z.enum(["active", "paused", "archived"]).optional()
+});
+var AddResourceInputSchema = z.object({
+  projectId: z.string().min(1),
+  type: z.string().min(1),
+  label: z.string().min(1),
+  url: z.string().url().optional(),
+  content: z.string().optional()
+}).refine((v) => v.url !== void 0 || v.content !== void 0, {
+  message: "at least one of url/content must be set"
+});
+var ContactInputSchema = z.object({
+  channel: z.enum(["telegram", "email", "phone", "other"]),
+  value: z.string().min(1),
+  priority: z.number().int().min(0).default(0)
+});
+var AddPersonInputSchema = z.object({
+  name: z.string().min(1),
+  contacts: z.array(ContactInputSchema).default([]),
+  companyId: z.string().optional(),
+  globalTopics: z.array(z.string()).default([])
+});
+var UpdatePersonInputSchema = z.object({
+  id: z.string().min(1),
+  name: z.string().optional(),
+  contacts: z.array(ContactInputSchema).optional(),
+  companyId: z.string().optional(),
+  globalTopics: z.array(z.string()).optional()
+});
+var AddCompanyInputSchema = z.object({
+  name: z.string().min(1)
+});
+var AddMemberInputSchema = z.object({
+  personId: z.string().min(1),
+  projectId: z.string().min(1),
+  role: z.string().min(1),
+  topics: z.array(z.string()).optional(),
+  priority: z.number().int().min(0).default(0)
+});
+var WhoToContactInputSchema = z.object({
+  topic: z.string().min(1),
+  projectId: z.string().optional()
+});
+var AddCommitmentInputSchema = z.object({
+  text: z.string().min(1),
+  personId: z.string().optional(),
+  projectId: z.string().optional(),
+  remindAt: z.number().optional(),
+  staleAfterDays: z.number().int().positive().default(DEFAULT_STALE_AFTER_DAYS)
+});
+var ListCommitmentsInputSchema = z.object({
+  status: z.enum(["open", "done", "dropped"]).optional(),
+  projectId: z.string().optional(),
+  staleOnly: z.boolean().default(false)
+});
+var CommitmentDoneInputSchema = z.object({ id: z.string().min(1) });
+var CommitmentDropInputSchema = z.object({
+  id: z.string().min(1),
+  reason: z.string().min(1)
+});
+var CommitmentSnoozeInputSchema = z.object({
+  id: z.string().min(1),
+  until: z.number(),
+  reason: z.string().optional()
+});
+var AddEventInputSchema = z.object({
+  subjectType: z.enum(["project", "person", "commitment", "company", "resource"]),
+  subjectId: z.string().min(1),
+  kind: z.string().min(1).default("note"),
+  text: z.string().optional(),
+  reason: z.string().optional(),
+  meta: z.record(z.string(), z.unknown()).optional()
+});
+var ListEventsInputSchema = z.object({
+  subjectType: z.enum(["project", "person", "commitment", "company", "resource"]).optional(),
+  subjectId: z.string().optional(),
+  kind: z.string().optional(),
+  since: z.number().optional()
+});
+var AddTopicInputSchema = z.object({
+  name: z.string().min(1),
+  aliases: z.array(z.string()).default([])
+});
+
+export { AddCommitmentInputSchema, AddCompanyInputSchema, AddEventInputSchema, AddMemberInputSchema, AddPersonInputSchema, AddProjectInputSchema, AddResourceInputSchema, AddTopicInputSchema, COLLECTIONS, CommitmentDoneInputSchema, CommitmentDropInputSchema, CommitmentSnoozeInputSchema, ContactInputSchema, DEFAULT_STALE_AFTER_DAYS, DERIVED_EVENT_KINDS, EVENT_RETENTION_MAX_AGE_MS, ListCommitmentsInputSchema, ListEventsInputSchema, ListProjectsInputSchema, SEMANTIC_EVENT_KINDS, TRACE_EVENT_KINDS, UpdatePersonInputSchema, UpdateProjectInputSchema, WhoToContactInputSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/event.ts","../src/constants.ts","../src/inputs.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Timestamped, EventSubjectType } from './common.js';\n\nexport type EventKind =\n  // semantic — never retained-out, see ADR-0001 §\"Ретеншен событий\"\n  | 'note'\n  | 'project.created'\n  | 'project.status_changed'\n  | 'commitment.created'\n  | 'commitment.done'\n  | 'commitment.dropped'\n  | 'commitment.rescheduled'\n  | 'person.merged'\n  // derived — 90 day retention\n  | 'review.generated'\n  | 'integrity.checked'\n  | 'export.completed'\n  // trace — 14 day retention\n  | 'backfill.imported';\n\nexport const SEMANTIC_EVENT_KINDS: readonly EventKind[] = [\n  'note',\n  'project.created',\n  'project.status_changed',\n  'commitment.created',\n  'commitment.done',\n  'commitment.dropped',\n  'commitment.rescheduled',\n  'person.merged',\n];\n\nexport const DERIVED_EVENT_KINDS: readonly EventKind[] = [\n  'review.generated',\n  'integrity.checked',\n  'export.completed',\n];\n\nexport const TRACE_EVENT_KINDS: readonly EventKind[] = ['backfill.imported'];\n\n/**\n * Append-only history log — the thing that makes the memory \"infinite\".\n * `subjectType`/`subjectId` are a polymorphic reference on purpose (flat,\n * not nested — `DocumentFilter` only supports top-level keys) so new\n * entities never require a schema change here. See ADR-0001 §Event.\n */\nexport interface Event extends Timestamped {\n  at: number;\n  kind: EventKind;\n  subjectType: EventSubjectType;\n  subjectId: string;\n  reason?: string;\n  text?: string;\n  meta?: Record<string, unknown>;\n}\n","/**\n * Collection names — must match what `core` passes to `ensureCollection`.\n * Actual storage names are namespaced by the platform as `steward__<name>`.\n */\nexport const COLLECTIONS = {\n  projects: 'projects',\n  resources: 'resources',\n  people: 'people',\n  companies: 'companies',\n  projectMembers: 'project_members',\n  commitments: 'commitments',\n  events: 'events',\n  topics: 'topics',\n} as const;\n\n/** Default commitment staleness threshold — see ADR-0001 §Commitment. */\nexport const DEFAULT_STALE_AFTER_DAYS = 14;\n\n/** Event retention classes — see ADR-0001 §\"Ретеншен событий\". `semantic` is never deleted. */\nexport const EVENT_RETENTION_MAX_AGE_MS: Record<'derived' | 'trace', number> = {\n  derived: 90 * 24 * 60 * 60 * 1000,\n  trace: 14 * 24 * 60 * 60 * 1000,\n};\n","/**\n * Zod schemas for everything that crosses the CLI/MCP boundary — command\n * inputs and the results agents read back. Domain models in `types/` stay\n * plain interfaces (see ADR-0001 §\"Разделение core/entry\").\n */\nimport { z } from 'zod';\nimport { DEFAULT_STALE_AFTER_DAYS } from './constants.js';\n\n// ── Project ──────────────────────────────────────────────────────────────\n\nexport const AddProjectInputSchema = z.object({\n  name: z.string().min(1),\n  status: z.enum(['active', 'paused', 'archived']).default('active'),\n  description: z.string().optional(),\n});\nexport type AddProjectInput = z.infer<typeof AddProjectInputSchema>;\n\nexport const UpdateProjectInputSchema = z.object({\n  id: z.string().min(1),\n  status: z.enum(['active', 'paused', 'archived']).optional(),\n  description: z.string().optional(),\n});\nexport type UpdateProjectInput = z.infer<typeof UpdateProjectInputSchema>;\n\nexport const ListProjectsInputSchema = z.object({\n  status: z.enum(['active', 'paused', 'archived']).optional(),\n});\nexport type ListProjectsInput = z.infer<typeof ListProjectsInputSchema>;\n\n// ── Resource ─────────────────────────────────────────────────────────────\n\nexport const AddResourceInputSchema = z\n  .object({\n    projectId: z.string().min(1),\n    type: z.string().min(1),\n    label: z.string().min(1),\n    url: z.string().url().optional(),\n    content: z.string().optional(),\n  })\n  .refine((v) => v.url !== undefined || v.content !== undefined, {\n    message: 'at least one of url/content must be set',\n  });\nexport type AddResourceInput = z.infer<typeof AddResourceInputSchema>;\n\n// ── Person / Company / ProjectMember ────────────────────────────────────\n\nexport const ContactInputSchema = z.object({\n  channel: z.enum(['telegram', 'email', 'phone', 'other']),\n  value: z.string().min(1),\n  priority: z.number().int().min(0).default(0),\n});\n\nexport const AddPersonInputSchema = z.object({\n  name: z.string().min(1),\n  contacts: z.array(ContactInputSchema).default([]),\n  companyId: z.string().optional(),\n  globalTopics: z.array(z.string()).default([]),\n});\nexport type AddPersonInput = z.infer<typeof AddPersonInputSchema>;\n\nexport const UpdatePersonInputSchema = z.object({\n  id: z.string().min(1),\n  name: z.string().optional(),\n  contacts: z.array(ContactInputSchema).optional(),\n  companyId: z.string().optional(),\n  globalTopics: z.array(z.string()).optional(),\n});\nexport type UpdatePersonInput = z.infer<typeof UpdatePersonInputSchema>;\n\nexport const AddCompanyInputSchema = z.object({\n  name: z.string().min(1),\n});\nexport type AddCompanyInput = z.infer<typeof AddCompanyInputSchema>;\n\nexport const AddMemberInputSchema = z.object({\n  personId: z.string().min(1),\n  projectId: z.string().min(1),\n  role: z.string().min(1),\n  topics: z.array(z.string()).optional(),\n  priority: z.number().int().min(0).default(0),\n});\nexport type AddMemberInput = z.infer<typeof AddMemberInputSchema>;\n\n// ── Routing ──────────────────────────────────────────────────────────────\n\nexport const WhoToContactInputSchema = z.object({\n  topic: z.string().min(1),\n  projectId: z.string().optional(),\n});\nexport type WhoToContactInput = z.infer<typeof WhoToContactInputSchema>;\n\n// ── Commitment ───────────────────────────────────────────────────────────\n\nexport const AddCommitmentInputSchema = z.object({\n  text: z.string().min(1),\n  personId: z.string().optional(),\n  projectId: z.string().optional(),\n  remindAt: z.number().optional(),\n  staleAfterDays: z.number().int().positive().default(DEFAULT_STALE_AFTER_DAYS),\n});\nexport type AddCommitmentInput = z.infer<typeof AddCommitmentInputSchema>;\n\nexport const ListCommitmentsInputSchema = z.object({\n  status: z.enum(['open', 'done', 'dropped']).optional(),\n  projectId: z.string().optional(),\n  staleOnly: z.boolean().default(false),\n});\nexport type ListCommitmentsInput = z.infer<typeof ListCommitmentsInputSchema>;\n\nexport const CommitmentDoneInputSchema = z.object({ id: z.string().min(1) });\nexport type CommitmentDoneInput = z.infer<typeof CommitmentDoneInputSchema>;\n\nexport const CommitmentDropInputSchema = z.object({\n  id: z.string().min(1),\n  reason: z.string().min(1),\n});\nexport type CommitmentDropInput = z.infer<typeof CommitmentDropInputSchema>;\n\nexport const CommitmentSnoozeInputSchema = z.object({\n  id: z.string().min(1),\n  until: z.number(),\n  reason: z.string().optional(),\n});\nexport type CommitmentSnoozeInput = z.infer<typeof CommitmentSnoozeInputSchema>;\n\n// ── Event ────────────────────────────────────────────────────────────────\n\nexport const AddEventInputSchema = z.object({\n  subjectType: z.enum(['project', 'person', 'commitment', 'company', 'resource']),\n  subjectId: z.string().min(1),\n  kind: z.string().min(1).default('note'),\n  text: z.string().optional(),\n  reason: z.string().optional(),\n  meta: z.record(z.string(), z.unknown()).optional(),\n});\nexport type AddEventInput = z.infer<typeof AddEventInputSchema>;\n\nexport const ListEventsInputSchema = z.object({\n  subjectType: z.enum(['project', 'person', 'commitment', 'company', 'resource']).optional(),\n  subjectId: z.string().optional(),\n  kind: z.string().optional(),\n  since: z.number().optional(),\n});\nexport type ListEventsInput = z.infer<typeof ListEventsInputSchema>;\n\n// ── Topic ────────────────────────────────────────────────────────────────\n\nexport const AddTopicInputSchema = z.object({\n  name: z.string().min(1),\n  aliases: z.array(z.string()).default([]),\n});\nexport type AddTopicInput = z.infer<typeof AddTopicInputSchema>;\n"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kb-labs/steward-contracts",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Domain types and input schemas for the steward personal PM/CRM plugin",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "2.118.2"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  }
+}