@apexops/contracts 0.10.0-next.0

package/dist/improvement.js

@@ -0,0 +1,119 @@
+import { Type } from "@sinclair/typebox";
+import { ContractVersionSchema, IsoDateTimeSchema, NonEmptyStringSchema, ProjectIdSchema, RunIdSchema, Sha256Schema, } from "./common.js";
+import { ConfidenceSchema } from "./targets.js";
+export const ImprovementSourceSchema = Type.Union([
+    Type.Literal("task-completion"),
+    Type.Literal("deterministic-test"),
+    Type.Literal("validation-failure"),
+    Type.Literal("capability-execution"),
+    Type.Literal("cache-check"),
+    Type.Literal("explicit-correction"),
+]);
+export const ImprovementCategorySchema = Type.Union([
+    Type.Literal("correctness"),
+    Type.Literal("security"),
+    Type.Literal("reliability"),
+    Type.Literal("performance"),
+    Type.Literal("usability"),
+    Type.Literal("documentation"),
+    Type.Literal("capability-gap"),
+]);
+export const ImprovementTargetSchema = Type.Union([
+    Type.Literal("documentation"),
+    Type.Literal("validator"),
+    Type.Literal("instruction"),
+    Type.Literal("skill"),
+    Type.Literal("architecture"),
+    Type.Literal("backlog"),
+]);
+export const ImprovementObservationV1Schema = Type.Object({
+    schemaVersion: ContractVersionSchema,
+    projectId: ProjectIdSchema,
+    runId: RunIdSchema,
+    taskId: Type.Optional(NonEmptyStringSchema),
+    observationId: Sha256Schema,
+    patternKey: Sha256Schema,
+    observedAt: IsoDateTimeSchema,
+    source: ImprovementSourceSchema,
+    category: ImprovementCategorySchema,
+    severity: Type.Union([
+        Type.Literal("critical"),
+        Type.Literal("high"),
+        Type.Literal("medium"),
+        Type.Literal("low"),
+        Type.Literal("info"),
+    ]),
+    statement: Type.String({ minLength: 1, maxLength: 1024 }),
+    evidenceRefs: Type.Array(Sha256Schema, { minItems: 1, uniqueItems: true, maxItems: 32 }),
+    disposition: Type.Union([Type.Literal("active"), Type.Literal("quarantined")]),
+    redactionCount: Type.Integer({ minimum: 0 }),
+}, { $id: "https://schemas.apexops.dev/improvement-observation-v1.json", additionalProperties: false });
+export const ImprovementRecurrenceV1Schema = Type.Object({
+    schemaVersion: ContractVersionSchema,
+    projectId: ProjectIdSchema,
+    patternKey: Sha256Schema,
+    category: ImprovementCategorySchema,
+    detectedAt: IsoDateTimeSchema,
+    firstSeenAt: IsoDateTimeSchema,
+    lastSeenAt: IsoDateTimeSchema,
+    occurrenceCount: Type.Integer({ minimum: 2 }),
+    distinctRunCount: Type.Integer({ minimum: 2 }),
+    runIds: Type.Array(RunIdSchema, { minItems: 2, uniqueItems: true }),
+    observationIds: Type.Array(Sha256Schema, { minItems: 2, uniqueItems: true }),
+    evidenceRefs: Type.Array(Sha256Schema, { minItems: 1, uniqueItems: true }),
+    confidence: ConfidenceSchema,
+}, { $id: "https://schemas.apexops.dev/improvement-recurrence-v1.json", additionalProperties: false });
+export const ImprovementProposalV1Schema = Type.Object({
+    schemaVersion: ContractVersionSchema,
+    projectId: ProjectIdSchema,
+    proposalId: Sha256Schema,
+    patternKey: Sha256Schema,
+    generatedAt: IsoDateTimeSchema,
+    target: ImprovementTargetSchema,
+    title: Type.String({ minLength: 1, maxLength: 160 }),
+    summary: Type.String({ minLength: 1, maxLength: 2048 }),
+    occurrenceCount: Type.Integer({ minimum: 2 }),
+    runIds: Type.Array(RunIdSchema, { minItems: 2, uniqueItems: true }),
+    evidenceRefs: Type.Array(Sha256Schema, { minItems: 1, uniqueItems: true }),
+    confidence: ConfidenceSchema,
+    status: Type.Union([
+        Type.Literal("pending"),
+        Type.Literal("accepted"),
+        Type.Literal("rejected"),
+        Type.Literal("deferred"),
+    ]),
+    inert: Type.Literal(true),
+}, { $id: "https://schemas.apexops.dev/improvement-proposal-v1.json", additionalProperties: false });
+export const ImprovementDecisionV1Schema = Type.Object({
+    schemaVersion: ContractVersionSchema,
+    projectId: ProjectIdSchema,
+    proposalId: Sha256Schema,
+    decidedAt: IsoDateTimeSchema,
+    actor: NonEmptyStringSchema,
+    decision: Type.Union([Type.Literal("accepted"), Type.Literal("rejected"), Type.Literal("deferred")]),
+    rationale: Type.String({ minLength: 1, maxLength: 2048 }),
+    externalRef: Type.Optional(Type.String({ pattern: "^https://github\\.com/[^/]+/[^/]+/(?:issues|pull)/[1-9][0-9]*$" })),
+}, { $id: "https://schemas.apexops.dev/improvement-decision-v1.json", additionalProperties: false });
+export const ImprovementPolicyV1Schema = Type.Object({
+    schemaVersion: ContractVersionSchema,
+    allowedSources: Type.Array(ImprovementSourceSchema, { minItems: 1, uniqueItems: true }),
+    allowedCategories: Type.Array(ImprovementCategorySchema, { minItems: 1, uniqueItems: true }),
+    recurrence: Type.Object({
+        threshold: Type.Integer({ minimum: 2 }),
+        windowDays: Type.Integer({ minimum: 1, maximum: 365 }),
+    }, { additionalProperties: false }),
+    retention: Type.Object({
+        observationDays: Type.Integer({ minimum: 1, maximum: 3650 }),
+        decisionDays: Type.Integer({ minimum: 1, maximum: 3650 }),
+    }, { additionalProperties: false }),
+    limits: Type.Object({
+        statementCharacters: Type.Integer({ minimum: 1, maximum: 1024 }),
+        evidenceRefs: Type.Integer({ minimum: 1, maximum: 32 }),
+        observations: Type.Integer({ minimum: 1, maximum: 100000 }),
+    }, { additionalProperties: false }),
+    proposalTargets: Type.Array(ImprovementTargetSchema, { minItems: 1, uniqueItems: true }),
+    humanDecisionRequired: Type.Literal(true),
+    automatedIssueCreation: Type.Literal(false),
+    contextInjection: Type.Literal(false),
+}, { $id: "https://schemas.apexops.dev/improvement-policy-v1.json", additionalProperties: false });
+//# sourceMappingURL=improvement.js.map

package/dist/improvement.js.map

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