@on-par/contracts 0.0.0-stage → 0.9.1

package/dist/hosted.d.ts

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+export declare const HOSTED_EXEC_FLAG = "FACTORY_HOSTED_EXEC";
+export declare const HostedJobStatusSchema: z.ZodEnum<{
+    canceled: "canceled";
+    done: "done";
+    failed: "failed";
+    leased: "leased";
+    requested: "requested";
+    running: "running";
+}>;
+export declare const HostedJobRequestSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    repoSlug: z.ZodString;
+    taskPayload: z.ZodString;
+    requiredCapabilities: z.ZodArray<z.ZodString>;
+    requiredAuthority: z.ZodString;
+    status: z.ZodEnum<{
+        canceled: "canceled";
+        done: "done";
+        failed: "failed";
+        leased: "leased";
+        requested: "requested";
+        running: "running";
+    }>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const HostedJobEventTypeSchema: z.ZodEnum<{
+    canceled: "canceled";
+    cleaned: "cleaned";
+    completed: "completed";
+    expired: "expired";
+    failed: "failed";
+    heartbeat: "heartbeat";
+    leased: "leased";
+    requested: "requested";
+    watchdog: "watchdog";
+}>;
+export declare const HostedJobEventSeveritySchema: z.ZodEnum<{
+    error: "error";
+    info: "info";
+    warn: "warn";
+}>;
+export declare const HostedJobEventSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    type: z.ZodEnum<{
+        canceled: "canceled";
+        cleaned: "cleaned";
+        completed: "completed";
+        expired: "expired";
+        failed: "failed";
+        heartbeat: "heartbeat";
+        leased: "leased";
+        requested: "requested";
+        watchdog: "watchdog";
+    }>;
+    ts: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        info: "info";
+        warn: "warn";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const RunnerLeaseSchema: z.ZodObject<{
+    runnerId: z.ZodString;
+    leaseId: z.ZodString;
+    jobId: z.ZodString;
+    expiresAt: z.ZodString;
+    heartbeatIntervalMs: z.ZodNumber;
+}, z.core.$strip>;
+export declare const HostedJobPhaseSchema: z.ZodEnum<{
+    cleanup: "cleanup";
+    clone: "clone";
+    run: "run";
+}>;
+export type HostedJobPhase = z.infer<typeof HostedJobPhaseSchema>;
+/** Metadata-only reference to a produced artifact — never inline content or a
+ * secret value. `ref` is an opaque retained handle (a path or store handle). */
+export declare const HostedArtifactRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    ref: z.ZodString;
+    kind: z.ZodString;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+    sha256: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HostedArtifactRef = z.infer<typeof HostedArtifactRefSchema>;
+export declare const HostedJobOutcomeSchema: z.ZodEnum<{
+    canceled: "canceled";
+    completed: "completed";
+    failed: "failed";
+}>;
+export declare const HostedJobResultSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    outcome: z.ZodEnum<{
+        canceled: "canceled";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    summary: z.ZodString;
+    finishedAt: z.ZodString;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    failurePhase: z.ZodOptional<z.ZodEnum<{
+        cleanup: "cleanup";
+        clone: "clone";
+        run: "run";
+    }>>;
+    logsTail: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        ref: z.ZodString;
+        kind: z.ZodString;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        sha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ProviderKindSchema: z.ZodEnum<{
+    "claude-code-oauth": "claude-code-oauth";
+    "codex-oauth": "codex-oauth";
+    "opencode-go-oauth": "opencode-go-oauth";
+    "pi-dev": "pi-dev";
+}>;
+export type ProviderKind = z.infer<typeof ProviderKindSchema>;
+/** A single piece of provider session material referenced by an opaque handle —
+ * never the raw secret. The broker resolves `handle` to real material at mount
+ * time; the handle is safe to persist in a job record. */
+export declare const ProviderSecretRefSchema: z.ZodObject<{
+    name: z.ZodString;
+    handle: z.ZodString;
+}, z.core.$strip>;
+export type ProviderSecretRef = z.infer<typeof ProviderSecretRefSchema>;
+/** A job-scoped bundle of provider session material. Scoped to exactly one job
+ * (`jobId`) so it is never ambient/shared runner state, and holds only opaque
+ * secret refs so raw OAuth material is never persisted. */
+export declare const ProviderSessionBundleSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        "claude-code-oauth": "claude-code-oauth";
+        "codex-oauth": "codex-oauth";
+        "opencode-go-oauth": "opencode-go-oauth";
+        "pi-dev": "pi-dev";
+    }>;
+    jobId: z.ZodString;
+    mountPath: z.ZodString;
+    secrets: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        handle: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProviderSessionBundle = z.infer<typeof ProviderSessionBundleSchema>;
+export type HostedJobStatus = z.infer<typeof HostedJobStatusSchema>;
+export type HostedJobRequest = z.infer<typeof HostedJobRequestSchema>;
+export type HostedJobEvent = z.infer<typeof HostedJobEventSchema>;
+export type RunnerLease = z.infer<typeof RunnerLeaseSchema>;
+export type HostedJobOutcome = z.infer<typeof HostedJobOutcomeSchema>;
+export type HostedJobResult = z.infer<typeof HostedJobResultSchema>;
+/** True only when the flag is exactly '1' — every other/absent value is off (default off). */
+export declare function hostedExecEnabled(env?: NodeJS.ProcessEnv): boolean;
+export interface HostedContractDemoResult {
+    enabled: boolean;
+    trace: string;
+    request?: HostedJobRequest;
+    event?: HostedJobEvent;
+    lease?: RunnerLease;
+}
+/** Pure demo: job requested -> event emitted -> runner leaseable. Constructs
+ * nothing when the flag is off — no fs, no network, no child_process, no Docker. */
+export declare function runHostedContractDemo(env?: NodeJS.ProcessEnv): HostedContractDemoResult;
+//# sourceMappingURL=hosted.d.ts.map

package/dist/hosted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.d.ts","sourceRoot":"","sources":["../src/hosted.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,eAAO,MAAM,qBAAqB;;;;;;;EAA2E,CAAC;AAE9G,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAWjC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;EAUnC,CAAC;AACH,eAAO,MAAM,4BAA4B;;;;EAAoC,CAAC;AAE9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAO/B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;iBAQ5B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;EAAsC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;gFACgF;AAChF,eAAO,MAAM,uBAAuB;;;;;;iBASlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,sBAAsB;;;;EAA8C,CAAC;AAClF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;iBAchC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;EAA8E,CAAC;AAC9G,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;0DAE0D;AAC1D,eAAO,MAAM,uBAAuB;;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;2DAE2D;AAC3D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAMtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE/E;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAMD;oFACoF;AACpF,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,wBAAwB,CAkCpG"}

package/dist/hosted.js

@@ -0,0 +1,140 @@
+// src/hosted.ts — Hosted (remote-runner) execution contract: shared vocabulary and
+// off-by-default safety switch for the hosted-exec architecture (#896, parent #895).
+import { z } from 'zod';
+export const HOSTED_EXEC_FLAG = 'FACTORY_HOSTED_EXEC';
+export const HostedJobStatusSchema = z.enum(['requested', 'leased', 'running', 'done', 'failed', 'canceled']);
+export const HostedJobRequestSchema = z.object({
+    jobId: z.string().min(1),
+    /** "owner/repo" */
+    repoSlug: z.string().min(1),
+    /** Opaque task description. */
+    taskPayload: z.string().min(1),
+    requiredCapabilities: z.array(z.string().min(1)),
+    requiredAuthority: z.string().min(1),
+    status: HostedJobStatusSchema,
+    /** ISO-8601. */
+    createdAt: z.string(),
+});
+export const HostedJobEventTypeSchema = z.enum([
+    'requested',
+    'leased',
+    'heartbeat',
+    'completed',
+    'failed',
+    'expired',
+    'cleaned',
+    'canceled',
+    'watchdog',
+]);
+export const HostedJobEventSeveritySchema = z.enum(['info', 'warn', 'error']);
+export const HostedJobEventSchema = z.object({
+    jobId: z.string().min(1),
+    type: HostedJobEventTypeSchema,
+    /** ISO-8601. */
+    ts: z.string(),
+    severity: HostedJobEventSeveritySchema,
+    message: z.string().min(1),
+});
+export const RunnerLeaseSchema = z.object({
+    runnerId: z.string().min(1),
+    leaseId: z.string().min(1),
+    jobId: z.string().min(1),
+    /** ISO-8601 expiry. */
+    expiresAt: z.string(),
+    /** Heartbeat expectation. */
+    heartbeatIntervalMs: z.number().int().positive(),
+});
+export const HostedJobPhaseSchema = z.enum(['clone', 'run', 'cleanup']);
+/** Metadata-only reference to a produced artifact — never inline content or a
+ * secret value. `ref` is an opaque retained handle (a path or store handle). */
+export const HostedArtifactRefSchema = z.object({
+    /** Display/logical name, e.g. 'build.log', 'coverage'. */
+    name: z.string().min(1),
+    /** Opaque retained reference — a path or store handle. NEVER inline content. */
+    ref: z.string().min(1),
+    /** e.g. 'log', 'report', 'patch'. */
+    kind: z.string().min(1),
+    sizeBytes: z.number().int().nonnegative().optional(),
+    sha256: z.string().optional(),
+});
+export const HostedJobOutcomeSchema = z.enum(['completed', 'failed', 'canceled']);
+export const HostedJobResultSchema = z.object({
+    jobId: z.string().min(1),
+    outcome: HostedJobOutcomeSchema,
+    summary: z.string().min(1),
+    /** ISO-8601. */
+    finishedAt: z.string(),
+    /** Container/process exit code when a process ran. */
+    exitCode: z.number().int().optional(),
+    /** Phase reached when the job failed — diagnosis aid. */
+    failurePhase: HostedJobPhaseSchema.optional(),
+    /** Bounded tail of recent logs; MUST already be secret-redacted by the caller. */
+    logsTail: z.string().optional(),
+    /** Metadata for produced artifacts; never inline content or secret values. */
+    artifacts: z.array(HostedArtifactRefSchema).optional(),
+});
+export const ProviderKindSchema = z.enum(['codex-oauth', 'claude-code-oauth', 'opencode-go-oauth', 'pi-dev']);
+/** A single piece of provider session material referenced by an opaque handle —
+ * never the raw secret. The broker resolves `handle` to real material at mount
+ * time; the handle is safe to persist in a job record. */
+export const ProviderSecretRefSchema = z.object({
+    /** Logical name inside the provider's session, e.g. 'oauth_token', 'refresh_token'. */
+    name: z.string().min(1),
+    /** Opaque broker handle; NEVER the secret value. */
+    handle: z.string().min(1),
+});
+/** A job-scoped bundle of provider session material. Scoped to exactly one job
+ * (`jobId`) so it is never ambient/shared runner state, and holds only opaque
+ * secret refs so raw OAuth material is never persisted. */
+export const ProviderSessionBundleSchema = z.object({
+    provider: ProviderKindSchema,
+    jobId: z.string().min(1),
+    /** Where the provider CLI expects its session dir inside the container, e.g. '/root/.codex'. */
+    mountPath: z.string().min(1),
+    secrets: z.array(ProviderSecretRefSchema).min(1),
+});
+/** True only when the flag is exactly '1' — every other/absent value is off (default off). */
+export function hostedExecEnabled(env = process.env) {
+    return env[HOSTED_EXEC_FLAG] === '1';
+}
+/** Fixed literal timestamp — this is a contract proof, not a live run, so the
+ * output is deterministic and no clock is read. */
+const DEMO_TS = '2026-01-01T00:00:00.000Z';
+/** Pure demo: job requested -> event emitted -> runner leaseable. Constructs
+ * nothing when the flag is off — no fs, no network, no child_process, no Docker. */
+export function runHostedContractDemo(env = process.env) {
+    if (!hostedExecEnabled(env)) {
+        return { enabled: false, trace: 'hosted execution disabled — local path unchanged' };
+    }
+    const request = HostedJobRequestSchema.parse({
+        jobId: 'demo-job-1',
+        repoSlug: 'on-par/software-factory',
+        taskPayload: 'demo: prove the hosted contract path',
+        requiredCapabilities: ['git', 'node'],
+        requiredAuthority: 'repo:write',
+        status: 'requested',
+        createdAt: DEMO_TS,
+    });
+    const event = HostedJobEventSchema.parse({
+        jobId: request.jobId,
+        type: 'requested',
+        ts: DEMO_TS,
+        severity: 'info',
+        message: 'hosted job requested',
+    });
+    const lease = RunnerLeaseSchema.parse({
+        runnerId: 'demo-runner-1',
+        leaseId: 'demo-lease-1',
+        jobId: request.jobId,
+        expiresAt: DEMO_TS,
+        heartbeatIntervalMs: 30_000,
+    });
+    return {
+        enabled: true,
+        request,
+        event,
+        lease,
+        trace: 'job requested -> event emitted -> runner leaseable',
+    };
+}
+//# sourceMappingURL=hosted.js.map

package/dist/hosted.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './adr.js';
+export * from './design.js';
+export * from './gherkin.js';
+export * from './hosted.js';
+export * from './issue.js';
+export * from './lifecycle.js';
+export * from './serde.js';
+export * from './trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// src/index.ts — @on-par/contracts public surface (#466).
+export * from './adr.js';
+export * from './design.js';
+export * from './gherkin.js';
+export * from './hosted.js';
+export * from './issue.js';
+export * from './lifecycle.js';
+export * from './serde.js';
+export * from './trace.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/issue.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+/** Bumped when a field is removed or its meaning changes; additive fields do not bump it. */
+export declare const CONTRACTS_SCHEMA_VERSION = 1;
+export declare const IssueKindSchema: z.ZodEnum<{
+    bug: "bug";
+    epic: "epic";
+    story: "story";
+    task: "task";
+}>;
+export declare const EngineeringReadyIssueSchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    number: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodEnum<{
+        bug: "bug";
+        epic: "epic";
+        story: "story";
+        task: "task";
+    }>;
+    title: z.ZodString;
+    problemStatement: z.ZodString;
+    inScope: z.ZodArray<z.ZodString>;
+    outOfScope: z.ZodArray<z.ZodString>;
+    acceptanceCriteria: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        given: z.ZodArray<z.ZodString>;
+        when: z.ZodArray<z.ZodString>;
+        then: z.ZodArray<z.ZodString>;
+        tracesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    verification: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        passWhen: z.ZodString;
+    }, z.core.$strip>>;
+    filesLikelyTouched: z.ZodArray<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+    tracesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const StorySchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    number: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodString;
+    problemStatement: z.ZodString;
+    inScope: z.ZodArray<z.ZodString>;
+    outOfScope: z.ZodArray<z.ZodString>;
+    acceptanceCriteria: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        given: z.ZodArray<z.ZodString>;
+        when: z.ZodArray<z.ZodString>;
+        then: z.ZodArray<z.ZodString>;
+        tracesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    verification: z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        passWhen: z.ZodString;
+    }, z.core.$strip>>;
+    filesLikelyTouched: z.ZodArray<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+    tracesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    kind: z.ZodLiteral<"story">;
+    role: z.ZodString;
+    want: z.ZodString;
+    soThat: z.ZodString;
+    investNote: z.ZodOptional<z.ZodString>;
+    epic: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const EpicSchema: z.ZodObject<{
+    schemaVersion: z.ZodDefault<z.ZodLiteral<1>>;
+    number: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"epic">;
+    title: z.ZodString;
+    why: z.ZodString;
+    doneWhen: z.ZodArray<z.ZodString>;
+    children: z.ZodArray<z.ZodString>;
+    whatAlreadyExists: z.ZodOptional<z.ZodString>;
+    labels: z.ZodArray<z.ZodString>;
+    tracesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type IssueKind = z.infer<typeof IssueKindSchema>;
+export type EngineeringReadyIssue = z.infer<typeof EngineeringReadyIssueSchema>;
+export type Story = z.infer<typeof StorySchema>;
+export type Epic = z.infer<typeof EpicSchema>;
+//# sourceMappingURL=issue.d.ts.map

package/dist/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../src/issue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,eAAe;;;;;EAA2C,CAAC;AAExE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAetC,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;iBAarB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/issue.js

@@ -0,0 +1,49 @@
+// src/issue.ts — The engineering-ready work-item seam: what the proposer exports and the
+// writer ingests (#466). Field names mirror .github/ISSUE_TEMPLATE/*.yml.
+import { z } from 'zod';
+import { VerificationStepSchema } from './design.js';
+import { AcceptanceCriterionSchema } from './gherkin.js';
+import { TracesToSchema } from './trace.js';
+/** Bumped when a field is removed or its meaning changes; additive fields do not bump it. */
+export const CONTRACTS_SCHEMA_VERSION = 1;
+export const IssueKindSchema = z.enum(['epic', 'story', 'task', 'bug']);
+export const EngineeringReadyIssueSchema = z.object({
+    schemaVersion: z.literal(CONTRACTS_SCHEMA_VERSION).default(CONTRACTS_SCHEMA_VERSION),
+    /** GitHub issue number, once filed. Absent while the proposer still holds it. */
+    number: z.number().int().positive().optional(),
+    kind: IssueKindSchema,
+    title: z.string().min(1),
+    problemStatement: z.string().min(1),
+    inScope: z.array(z.string().min(1)).min(1),
+    outOfScope: z.array(z.string().min(1)),
+    acceptanceCriteria: z.array(AcceptanceCriterionSchema).min(1),
+    verification: z.array(VerificationStepSchema).min(1),
+    filesLikelyTouched: z.array(z.string().min(1)),
+    labels: z.array(z.string().min(1)),
+    /** Intent statement IDs this artifact realizes (#471). Additive — does not bump the schema version. */
+    tracesTo: TracesToSchema.default([]),
+});
+export const StorySchema = EngineeringReadyIssueSchema.extend({
+    kind: z.literal('story'),
+    role: z.string().min(1),
+    want: z.string().min(1),
+    soThat: z.string().min(1),
+    investNote: z.string().min(1).optional(),
+    /** Parent epic's GitHub issue number. */
+    epic: z.number().int().positive().optional(),
+});
+export const EpicSchema = z.object({
+    schemaVersion: z.literal(CONTRACTS_SCHEMA_VERSION).default(CONTRACTS_SCHEMA_VERSION),
+    number: z.number().int().positive().optional(),
+    kind: z.literal('epic'),
+    title: z.string().min(1),
+    why: z.string().min(1),
+    doneWhen: z.array(z.string().min(1)).min(1),
+    /** Child stories: titles or "#123" references, in build order. */
+    children: z.array(z.string().min(1)),
+    whatAlreadyExists: z.string().min(1).optional(),
+    labels: z.array(z.string().min(1)),
+    /** Intent statement IDs this artifact realizes (#471). Additive — does not bump the schema version. */
+    tracesTo: TracesToSchema.default([]),
+});
+//# sourceMappingURL=issue.js.map

package/dist/issue.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+/** The four boss-worker-checker phases, lower-cased to match FactoryEvent.phase. */
+export declare const LANE_LIFECYCLE_PHASES: readonly ['plan', 'build', 'check', 'ship'];
+export declare const LaneLifecyclePhaseSchema: z.ZodEnum<{
+    build: "build";
+    check: "check";
+    plan: "plan";
+    ship: "ship";
+}>;
+export declare const LaneLifecycleStatusSchema: z.ZodEnum<{
+    done: "done";
+    failed: "failed";
+    progress: "progress";
+    started: "started";
+}>;
+export declare const LaneLifecycleEventSchema: z.ZodObject<{
+    ts: z.ZodString;
+    laneId: z.ZodString;
+    issueId: z.ZodString;
+    phase: z.ZodEnum<{
+        build: "build";
+        check: "check";
+        plan: "plan";
+        ship: "ship";
+    }>;
+    status: z.ZodEnum<{
+        done: "done";
+        failed: "failed";
+        progress: "progress";
+        started: "started";
+    }>;
+    detail: z.ZodString;
+    worktreePath: z.ZodString;
+}, z.core.$strip>;
+export type LaneLifecyclePhase = z.infer<typeof LaneLifecyclePhaseSchema>;
+export type LaneLifecycleStatus = z.infer<typeof LaneLifecycleStatusSchema>;
+export type LaneLifecycleEvent = z.infer<typeof LaneLifecycleEventSchema>;
+/** A lifecycle event annotated with the attached repository that produced it —
+ * the shape the server puts on the wire (`owner/name`). */
+export declare const RepositoryLaneLifecycleEventSchema: z.ZodObject<{
+    ts: z.ZodString;
+    laneId: z.ZodString;
+    issueId: z.ZodString;
+    phase: z.ZodEnum<{
+        build: "build";
+        check: "check";
+        plan: "plan";
+        ship: "ship";
+    }>;
+    status: z.ZodEnum<{
+        done: "done";
+        failed: "failed";
+        progress: "progress";
+        started: "started";
+    }>;
+    detail: z.ZodString;
+    worktreePath: z.ZodString;
+    repo: z.ZodString;
+}, z.core.$strip>;
+export type RepositoryLaneLifecycleEvent = z.infer<typeof RepositoryLaneLifecycleEventSchema>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,YAAI,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAEjF,eAAO,MAAM,wBAAwB;;;;;EAAgC,CAAC;AACtE,eAAO,MAAM,yBAAyB;;;;;EAAoD,CAAC;AAE3F,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;iBASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;2DAC2D;AAC3D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;iBAE7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}

package/dist/lifecycle.js

@@ -0,0 +1,22 @@
+// src/lifecycle.ts — Lane lifecycle event: the engine's in-process progress seam (#591).
+import { z } from 'zod';
+/** The four boss-worker-checker phases, lower-cased to match FactoryEvent.phase. */
+export const LANE_LIFECYCLE_PHASES = ['plan', 'build', 'check', 'ship'];
+export const LaneLifecyclePhaseSchema = z.enum(LANE_LIFECYCLE_PHASES);
+export const LaneLifecycleStatusSchema = z.enum(['started', 'progress', 'done', 'failed']);
+export const LaneLifecycleEventSchema = z.object({
+    /** ISO-8601, same clock format as FactoryEvent.ts. */
+    ts: z.string(),
+    laneId: z.string(),
+    issueId: z.string(),
+    phase: LaneLifecyclePhaseSchema,
+    status: LaneLifecycleStatusSchema,
+    detail: z.string(),
+    worktreePath: z.string(),
+});
+/** A lifecycle event annotated with the attached repository that produced it —
+ * the shape the server puts on the wire (`owner/name`). */
+export const RepositoryLaneLifecycleEventSchema = LaneLifecycleEventSchema.extend({
+    repo: z.string().min(1),
+});
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAC;AAEjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,sDAAsD;IACtD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,yBAAyB;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAMH;2DAC2D;AAC3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,wBAAwB,CAAC,MAAM,CAAC;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC"}

package/dist/serde.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+/** Validate then JSON-encode. Throws ZodError when `value` does not satisfy `schema`. */
+export declare function serialize<T>(schema: z.ZodType<T>, value: T): string;
+/** JSON-decode then validate. Throws SyntaxError or ZodError. */
+export declare function deserialize<T>(schema: z.ZodType<T>, raw: string): T;
+export type DeserializeResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    errors: string[];
+};
+/** Non-throwing `deserialize`. Malformed JSON reports `['json: <message>']`. */
+export declare function tryDeserialize<T>(schema: z.ZodType<T>, raw: string): DeserializeResult<T>;
+//# sourceMappingURL=serde.d.ts.map

package/dist/serde.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.d.ts","sourceRoot":"","sources":["../src/serde.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAEnE;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAEnE;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE5F,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CASzF"}

package/dist/serde.js

@@ -0,0 +1,24 @@
+function formatIssues(error) {
+    return error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+}
+/** Validate then JSON-encode. Throws ZodError when `value` does not satisfy `schema`. */
+export function serialize(schema, value) {
+    return JSON.stringify(schema.parse(value));
+}
+/** JSON-decode then validate. Throws SyntaxError or ZodError. */
+export function deserialize(schema, raw) {
+    return schema.parse(JSON.parse(raw));
+}
+/** Non-throwing `deserialize`. Malformed JSON reports `['json: <message>']`. */
+export function tryDeserialize(schema, raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        return { ok: false, errors: [`json: ${error instanceof Error ? error.message : String(error)}`] };
+    }
+    const result = schema.safeParse(parsed);
+    return result.success ? { ok: true, value: result.data } : { ok: false, errors: formatIssues(result.error) };
+}
+//# sourceMappingURL=serde.js.map

package/dist/serde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.js","sourceRoot":"","sources":["../src/serde.ts"],"names":[],"mappings":"AAIA,SAAS,YAAY,CAAC,KAAiB;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAI,MAAoB,EAAE,KAAQ;IACzD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAI,MAAoB,EAAE,GAAW;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAID,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAI,MAAoB,EAAE,GAAW;IACjE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/G,CAAC"}