@kynetic-ai/spec 0.11.0 → 0.12.0

package/dist/review/subject-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-bindings.d.ts","sourceRoot":"","sources":["../../src/review/subject-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,aAAa,EACd,MAAM,6BAA6B,CAAC;AAOrC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAepB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAOpB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAOpB;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAOpB;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,qBAAqB,CASxB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,GACrB,oBAAoB,CAwBtB;AAKD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,oBAAoB,EAC/B,cAAc,EAAE,oBAAoB,GACnC,eAAe,CAuCjB;AAGD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,cAAc,EAAE,oBAAoB,GACnC,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAQvE;AAGD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,cAAc,EAAE,oBAAoB,GACnC,KAAK,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAQ3E"}

package/dist/review/subject-bindings.js

@@ -0,0 +1,175 @@
+import { computeContentHash } from "../parser/skill-render.js";
+// --- Subject Binding Factories ---
+// AC: @review-subject-bindings ac-1
+// AC: @review-subject-bindings ac-3
+/**
+ * Create a code subject binding with git compare semantics.
+ * Commits are the authoritative identity; branch names are optional metadata.
+ */
+export function createCodeSubject(opts) {
+    return {
+        type: "code",
+        base_commit: opts.base_commit,
+        head_commit: opts.head_commit,
+        ...(opts.merge_base_commit !== undefined && {
+            merge_base_commit: opts.merge_base_commit,
+        }),
+        ...(opts.base_branch !== undefined && {
+            base_branch: opts.base_branch,
+        }),
+        ...(opts.head_branch !== undefined && {
+            head_branch: opts.head_branch,
+        }),
+    };
+}
+// AC: @review-subject-bindings ac-1
+// AC: @review-subject-bindings ac-4
+/**
+ * Create a plan subject binding with shadow branch commit and content hash.
+ */
+export function createPlanSubject(opts) {
+    return {
+        type: "plan",
+        ref: opts.ref,
+        shadow_commit: opts.shadow_commit,
+        content_hash: opts.content_hash,
+    };
+}
+// AC: @review-subject-bindings ac-1
+// AC: @review-subject-bindings ac-4
+/**
+ * Create a task subject binding with shadow branch commit and content hash.
+ */
+export function createTaskSubject(opts) {
+    return {
+        type: "task",
+        ref: opts.ref,
+        shadow_commit: opts.shadow_commit,
+        content_hash: opts.content_hash,
+    };
+}
+// AC: @review-subject-bindings ac-1
+// AC: @review-subject-bindings ac-4
+/**
+ * Create a spec subject binding with shadow branch commit and content hash.
+ */
+export function createSpecSubject(opts) {
+    return {
+        type: "spec",
+        ref: opts.ref,
+        shadow_commit: opts.shadow_commit,
+        content_hash: opts.content_hash,
+    };
+}
+// AC: @review-subject-bindings ac-1
+// AC: @review-subject-bindings ac-2
+/**
+ * Create an external subject binding.
+ * External identifiers are linkage metadata — the local kspec ref
+ * (if present via related_refs on the review record) remains authoritative.
+ */
+export function createExternalSubject(opts) {
+    return {
+        type: "external",
+        url: opts.url,
+        ...(opts.external_id !== undefined && {
+            external_id: opts.external_id,
+        }),
+        ...(opts.provider !== undefined && { provider: opts.provider }),
+    };
+}
+// --- Subject Version Extraction ---
+/**
+ * Extract the current subject version from a subject binding.
+ * This is used to create applies_to_version values for checks and verdicts.
+ */
+export function extractSubjectVersion(subject) {
+    if (subject.type === "code") {
+        return {
+            type: "code_compare",
+            base_commit: subject.base_commit,
+            head_commit: subject.head_commit,
+        };
+    }
+    // plan, task, spec all use content_hash
+    if (subject.type === "plan" ||
+        subject.type === "task" ||
+        subject.type === "spec") {
+        return {
+            type: "entity_version",
+            content_hash: subject.content_hash,
+        };
+    }
+    // external subjects don't have versioning — use URL as a synthetic hash
+    return {
+        type: "entity_version",
+        content_hash: computeContentHash(subject.url),
+    };
+}
+// AC: @review-subject-bindings ac-5
+/**
+ * Determine if a check or verdict is stale relative to the current subject version.
+ *
+ * For code subjects: compares base_commit and head_commit.
+ * For shadow-branch subjects (plan, task, spec): compares content_hash,
+ * NOT shadow branch HEAD, to avoid self-invalidation on review mutations.
+ */
+export function isVersionStale(appliesTo, currentVersion) {
+    // Type mismatch means the subject kind changed — always stale
+    if (appliesTo.type !== currentVersion.type) {
+        return {
+            stale: true,
+            reason: `Version type changed from ${appliesTo.type} to ${currentVersion.type}`,
+        };
+    }
+    if (appliesTo.type === "code_compare" &&
+        currentVersion.type === "code_compare") {
+        const commitChanged = appliesTo.base_commit !== currentVersion.base_commit ||
+            appliesTo.head_commit !== currentVersion.head_commit;
+        if (commitChanged) {
+            return {
+                stale: true,
+                reason: "Code compare commits have changed",
+            };
+        }
+        return { stale: false };
+    }
+    if (appliesTo.type === "entity_version" &&
+        currentVersion.type === "entity_version") {
+        if (appliesTo.content_hash !== currentVersion.content_hash) {
+            return {
+                stale: true,
+                reason: "Entity content hash has changed",
+            };
+        }
+        return { stale: false };
+    }
+    return { stale: false };
+}
+// AC: @review-subject-bindings ac-5
+/**
+ * Find all stale checks in a review given the current subject version.
+ */
+export function findStaleChecks(checks, currentVersion) {
+    return checks
+        .map((check, index) => ({
+        check,
+        index,
+        result: isVersionStale(check.applies_to_version, currentVersion),
+    }))
+        .filter((entry) => entry.result.stale);
+}
+// AC: @review-subject-bindings ac-5
+/**
+ * Find all stale verdicts in a review given the current subject version.
+ */
+export function findStaleVerdicts(verdicts, currentVersion) {
+    return verdicts
+        .map((verdict, index) => ({
+        verdict,
+        index,
+        result: isVersionStale(verdict.applies_to_version, currentVersion),
+    }))
+        .filter((entry) => entry.result.stale);
+}
+//# sourceMappingURL=subject-bindings.js.map

package/dist/review/subject-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject-bindings.js","sourceRoot":"","sources":["../../src/review/subject-bindings.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,oCAAoC;AAEpC,oCAAoC;AACpC,oCAAoC;AACpC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAMjC;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,IAAI;YAC1C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI;YACpC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI;YACpC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;KACH,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,oCAAoC;AACpC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,oCAAoC;AACpC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,oCAAoC;AACpC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAIjC;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,oCAAoC;AACpC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAIrC;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI;YACpC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,qCAAqC;AAErC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAsB;IAEtB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC;IACD,wCAAwC;IACxC,IACE,OAAO,CAAC,IAAI,KAAK,MAAM;QACvB,OAAO,CAAC,IAAI,KAAK,MAAM;QACvB,OAAO,CAAC,IAAI,KAAK,MAAM,EACvB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;IACJ,CAAC;IACD,wEAAwE;IACxE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC;KAC9C,CAAC;AACJ,CAAC;AAaD,oCAAoC;AACpC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA+B,EAC/B,cAAoC;IAEpC,8DAA8D;IAC9D,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,6BAA6B,SAAS,CAAC,IAAI,OAAO,cAAc,CAAC,IAAI,EAAE;SAChF,CAAC;IACJ,CAAC;IAED,IACE,SAAS,CAAC,IAAI,KAAK,cAAc;QACjC,cAAc,CAAC,IAAI,KAAK,cAAc,EACtC,CAAC;QACD,MAAM,aAAa,GACjB,SAAS,CAAC,WAAW,KAAK,cAAc,CAAC,WAAW;YACpD,SAAS,CAAC,WAAW,KAAK,cAAc,CAAC,WAAW,CAAC;QACvD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,mCAAmC;aAC5C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IACE,SAAS,CAAC,IAAI,KAAK,gBAAgB;QACnC,cAAc,CAAC,IAAI,KAAK,gBAAgB,EACxC,CAAC;QACD,IAAI,SAAS,CAAC,YAAY,KAAK,cAAc,CAAC,YAAY,EAAE,CAAC;YAC3D,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,iCAAiC;aAC1C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,oCAAoC;AACpC;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA8B,EAC9B,cAAoC;IAEpC,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtB,KAAK;QACL,KAAK;QACL,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,kBAAkB,EAAE,cAAc,CAAC;KACjE,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,oCAAoC;AACpC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkC,EAClC,cAAoC;IAEpC,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACxB,OAAO;QACP,KAAK;QACL,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,kBAAkB,EAAE,cAAc,CAAC;KACnE,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/dist/schema/common.d.ts

@@ -32,6 +32,31 @@ export declare const VcsRefSchema: z.ZodObject<{
     ref: string;
     type?: "branch" | "tag" | "commit" | undefined;
 }>;
+export declare const SubmissionLinkageSchema: z.ZodObject<{
+    branch: z.ZodNullable<z.ZodString>;
+    commit: z.ZodString;
+    remote: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    remote_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    upstream_ref: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    review_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    captured_at: z.ZodUnion<[z.ZodString, z.ZodString]>;
+}, "strip", z.ZodTypeAny, {
+    branch: string | null;
+    commit: string;
+    captured_at: string;
+    remote?: string | null | undefined;
+    remote_url?: string | null | undefined;
+    upstream_ref?: string | null | undefined;
+    review_url?: string | null | undefined;
+}, {
+    branch: string | null;
+    commit: string;
+    captured_at: string;
+    remote?: string | null | undefined;
+    remote_url?: string | null | undefined;
+    upstream_ref?: string | null | undefined;
+    review_url?: string | null | undefined;
+}>;
 export type Ulid = z.infer<typeof UlidSchema>;
 export type Slug = z.infer<typeof SlugSchema>;
 export type Ref = z.infer<typeof RefSchema>;
@@ -43,6 +68,7 @@ export type TaskStatus = z.infer<typeof TaskStatusSchema>;
 export type TaskType = z.infer<typeof TaskTypeSchema>;
 export type ItemType = z.infer<typeof ItemTypeSchema>;
 export type VcsRef = z.infer<typeof VcsRefSchema>;
+export type SubmissionLinkage = z.infer<typeof SubmissionLinkageSchema>;
 /**
  * Normalize a reference string to ensure @ prefix.
  * Apply at CLI input boundaries before constructing TaskInput/SpecItemInput.

package/dist/schema/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,WAAW,QAA8B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,UAAU,QAAqB,CAAC;AAG7C,eAAO,MAAM,UAAU,aAAuD,CAAC;AAC/E,eAAO,MAAM,UAAU,aAAuD,CAAC;AAC/E,eAAO,MAAM,SAAS,aAE0B,CAAC;AAGjD,eAAO,MAAM,cAAc,iEAGzB,CAAC;AAGH,eAAO,MAAM,cAAc,wCAGzB,CAAC;AAGH,eAAO,MAAM,cAAc,sEAMzB,CAAC;AAGH,eAAO,MAAM,0BAA0B,sEAKrC,CAAC;AAGH,eAAO,MAAM,gBAAgB,4GAQ3B,CAAC;AAGH,eAAO,MAAM,cAAc,sDAAoD,CAAC;AAGhF,eAAO,MAAM,cAAc,4FAQzB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,eAAO,MAAM,WAAW,QAA8B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,UAAU,QAAqB,CAAC;AAG7C,eAAO,MAAM,UAAU,aAAuD,CAAC;AAC/E,eAAO,MAAM,UAAU,aAAuD,CAAC;AAC/E,eAAO,MAAM,SAAS,aAE0B,CAAC;AAGjD,eAAO,MAAM,cAAc,iEAGzB,CAAC;AAGH,eAAO,MAAM,cAAc,wCAGzB,CAAC;AAGH,eAAO,MAAM,cAAc,sEAMzB,CAAC;AAGH,eAAO,MAAM,0BAA0B,sEAKrC,CAAC;AAGH,eAAO,MAAM,gBAAgB,4GAQ3B,CAAC;AAGH,eAAO,MAAM,cAAc,sDAAoD,CAAC;AAGhF,eAAO,MAAM,cAAc,4FAQzB,CAAC;AAGH,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAC;AAMH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAQlC,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/schema/common.js

@@ -71,6 +71,19 @@ export const VcsRefSchema = z.object({
     ref: z.string(),
     type: z.enum(["branch", "tag", "commit"]).optional(),
 });
+// AC: @portable-task-submission-linkage ac-1, ac-2
+// Structured submission linkage captured at task submit time.
+// Stores branch, commit, and remote context so another checkout
+// can recover the submitted code lineage for review and follow-up.
+export const SubmissionLinkageSchema = z.object({
+    branch: z.string().nullable(),
+    commit: z.string(),
+    remote: z.string().nullable().optional(),
+    remote_url: z.string().nullable().optional(),
+    upstream_ref: z.string().nullable().optional(),
+    review_url: z.string().url().nullable().optional(),
+    captured_at: DateTimeSchema,
+});
 /**
  * Normalize a reference string to ensure @ prefix.
  * Apply at CLI input boundaries before constructing TaskInput/SpecItemInput.

package/dist/schema/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAE7C,eAAe;AACf,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,KAAK,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAC;AAEjD,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC;IACpC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrB,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAClB,CAAC,CAAC;AAEH,kBAAkB;AAClB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,OAAO;IACP,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;CACb,CAAC,CAAC;AAEH,wBAAwB;AACxB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/C,aAAa;IACb,aAAa;IACb,aAAa;IACb,UAAU;CACX,CAAC,CAAC;AAEH,cAAc;AACd,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,WAAW;IACX,WAAW;CACZ,CAAC,CAAC;AAEH,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEhF,YAAY;AACZ,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,QAAQ;IACR,SAAS;IACT,aAAa;IACb,YAAY;IACZ,UAAU;IACV,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAcH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schema/common.ts"],"names":[],"mappings":"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"}