@specforge/cli 0.1.0 → 0.2.5

package/node_modules/@specforge/spec-types/dist/schema/auxiliary.d.ts

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+export declare const FieldDeclarationSchema: z.ZodObject<{
+    value: z.ZodLiteral<"N/A">;
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: "N/A";
+    reason: string;
+}, {
+    value: "N/A";
+    reason: string;
+}>;
+export declare const AcceptanceCriterionSchema: z.ZodObject<{
+    id: z.ZodString;
+    given: z.ZodString;
+    when: z.ZodString;
+    then: z.ZodString;
+    order: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    given: string;
+    when: string;
+    then: string;
+    order: number;
+}, {
+    id: string;
+    given: string;
+    when: string;
+    then: string;
+    order: number;
+}>;
+export declare const FileRoleEnum: z.ZodEnum<["creates", "modifies", "deletes", "imports", "reads"]>;
+export type FileRole = z.infer<typeof FileRoleEnum>;
+export declare const StepFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    role: z.ZodString;
+    symbol: z.ZodOptional<z.ZodString>;
+    why: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    role: string;
+    symbol?: string | undefined;
+    why?: string | undefined;
+}, {
+    path: string;
+    role: string;
+    symbol?: string | undefined;
+    why?: string | undefined;
+}>;
+export declare const ImplementationStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+    order: z.ZodNumber;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        role: z.ZodString;
+        symbol: z.ZodOptional<z.ZodString>;
+        why: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        role: string;
+        symbol?: string | undefined;
+        why?: string | undefined;
+    }, {
+        path: string;
+        role: string;
+        symbol?: string | undefined;
+        why?: string | undefined;
+    }>, "many">>;
+    linkedFileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    linkedCodeSnippetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    linkedTypeSnippetIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    order: number;
+    text: string;
+    files?: {
+        path: string;
+        role: string;
+        symbol?: string | undefined;
+        why?: string | undefined;
+    }[] | undefined;
+    linkedFileIds?: string[] | undefined;
+    linkedCodeSnippetIds?: string[] | undefined;
+    linkedTypeSnippetIds?: string[] | undefined;
+}, {
+    id: string;
+    order: number;
+    text: string;
+    files?: {
+        path: string;
+        role: string;
+        symbol?: string | undefined;
+        why?: string | undefined;
+    }[] | undefined;
+    linkedFileIds?: string[] | undefined;
+    linkedCodeSnippetIds?: string[] | undefined;
+    linkedTypeSnippetIds?: string[] | undefined;
+}>;
+export type FileChangeKind = FileRole;
+export declare const FileChangeRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodString;
+    symbol: z.ZodOptional<z.ZodString>;
+    why: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    id: string;
+    kind: string;
+    symbol?: string | undefined;
+    why?: string | undefined;
+}, {
+    path: string;
+    id: string;
+    kind: string;
+    symbol?: string | undefined;
+    why?: string | undefined;
+}>;
+export declare const TestTypeEnum: z.ZodEnum<["unit", "integration", "e2e", "typecheck", "lint", "build", "contract", "structural", "layout", "a11y", "performance"]>;
+export declare const TestSpecificationSchema: z.ZodObject<{
+    testTypes: z.ZodArray<z.ZodEnum<["unit", "integration", "e2e", "typecheck", "lint", "build", "contract", "structural", "layout", "a11y", "performance"]>, "many">;
+    qualityGates: z.ZodArray<z.ZodString, "many">;
+    testCommands: z.ZodArray<z.ZodString, "many">;
+    coverageTarget: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+    qualityGates: string[];
+    testCommands: string[];
+    coverageTarget?: number | null | undefined;
+}, {
+    testTypes: ("unit" | "integration" | "e2e" | "typecheck" | "lint" | "build" | "contract" | "structural" | "layout" | "a11y" | "performance")[];
+    qualityGates: string[];
+    testCommands: string[];
+    coverageTarget?: number | null | undefined;
+}>;
+export declare const CodeReferenceSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    symbol: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    symbol?: string | undefined;
+    description?: string | undefined;
+}, {
+    filePath: string;
+    symbol?: string | undefined;
+    description?: string | undefined;
+}>;
+export declare const TypeReferenceSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    typeName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    typeName: string;
+    description?: string | undefined;
+}, {
+    filePath: string;
+    typeName: string;
+    description?: string | undefined;
+}>;
+export declare const CodeSnippetSchema: z.ZodObject<{
+    id: z.ZodString;
+    language: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+    sourcePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    language: string;
+    content: string;
+    order?: number | undefined;
+    description?: string | undefined;
+    sourcePath?: string | undefined;
+}, {
+    id: string;
+    language: string;
+    content: string;
+    order?: number | undefined;
+    description?: string | undefined;
+    sourcePath?: string | undefined;
+}>;
+export declare const TypeSnippetSchema: z.ZodObject<{
+    id: z.ZodString;
+    language: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    order: z.ZodOptional<z.ZodNumber>;
+    sourcePath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    language: string;
+    content: string;
+    order?: number | undefined;
+    description?: string | undefined;
+    sourcePath?: string | undefined;
+}, {
+    id: string;
+    language: string;
+    content: string;
+    order?: number | undefined;
+    description?: string | undefined;
+    sourcePath?: string | undefined;
+}>;
+export declare const BlueprintReferenceSchema: z.ZodObject<{
+    blueprintId: z.ZodString;
+    context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    section: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    blueprintId: string;
+    context?: string | null | undefined;
+    section?: string | null | undefined;
+}, {
+    blueprintId: string;
+    context?: string | null | undefined;
+    section?: string | null | undefined;
+}>;
+export declare const DependencyOriginSchema: z.ZodObject<{
+    provenance: z.ZodOptional<z.ZodBoolean>;
+    scaffold: z.ZodOptional<z.ZodBoolean>;
+    semantic: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    provenance?: boolean | undefined;
+    scaffold?: boolean | undefined;
+    semantic?: boolean | undefined;
+}, {
+    provenance?: boolean | undefined;
+    scaffold?: boolean | undefined;
+    semantic?: boolean | undefined;
+}>;
+export type DependencyOrigin = z.infer<typeof DependencyOriginSchema>;
+export declare const DependencyLinkSchema: z.ZodObject<{
+    ticketId: z.ZodString;
+    type: z.ZodEnum<["requires", "blocks"]>;
+    origin: z.ZodOptional<z.ZodObject<{
+        provenance: z.ZodOptional<z.ZodBoolean>;
+        scaffold: z.ZodOptional<z.ZodBoolean>;
+        semantic: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        provenance?: boolean | undefined;
+        scaffold?: boolean | undefined;
+        semantic?: boolean | undefined;
+    }, {
+        provenance?: boolean | undefined;
+        scaffold?: boolean | undefined;
+        semantic?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "requires" | "blocks";
+    ticketId: string;
+    origin?: {
+        provenance?: boolean | undefined;
+        scaffold?: boolean | undefined;
+        semantic?: boolean | undefined;
+    } | undefined;
+}, {
+    type: "requires" | "blocks";
+    ticketId: string;
+    origin?: {
+        provenance?: boolean | undefined;
+        scaffold?: boolean | undefined;
+        semantic?: boolean | undefined;
+    } | undefined;
+}>;
+//# sourceMappingURL=auxiliary.d.ts.map

package/node_modules/@specforge/spec-types/dist/schema/auxiliary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.d.ts","sourceRoot":"","sources":["../../src/schema/auxiliary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAMpC,CAAC;AAQH,eAAO,MAAM,YAAY,mEAAiE,CAAC;AAC3F,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAcpD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBnC,CAAC;AAeH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,eAAO,MAAM,YAAY,oIAGvB,CAAC;AASH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAUnC,CAAC;AAOH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC"}

package/node_modules/@specforge/spec-types/dist/schema/auxiliary.js

@@ -0,0 +1,143 @@
+import { z } from 'zod';
+export const FieldDeclarationSchema = z.object({
+    value: z.literal('N/A'),
+    reason: z.string().min(20),
+});
+export const AcceptanceCriterionSchema = z.object({
+    id: z.string(),
+    given: z.string(),
+    when: z.string(),
+    then: z.string(),
+    order: z.number().int().min(1),
+});
+// ME.19.2 (D17) — the FIVE file roles a step declares on each file it touches.
+// `imports`/`reads` are DISTINCT (D17): `imports` couples + derives an ordering
+// edge (and freezes the file, §7b c); `reads` is an informational context glance
+// that derives NO edge. `creates`/`modifies`/`deletes` are the produced/mutated
+// set. This vocabulary is the AUTHORING source; the ticket-level `filesToBe*`
+// arrays become a DERIVED read projection reconstructed from these roles.
+export const FileRoleEnum = z.enum(['creates', 'modifies', 'deletes', 'imports', 'reads']);
+// ME.19.2 (D17) — step-as-atom: a step declares each file it touches by ROLE,
+// with optional `symbol` (the code symbol / type name the step couples to —
+// absorbs codeReferences.symbol / typeReferences.typeName) and `why` (absorbs
+// their `description`). ⚠ NO minCount on any role (D17 guardrail 1): a floor
+// satisfiable by any string is what manufactured filler in the abolished model.
+// ⚠ `role` is a plain `z.string()` here (NOT `FileRoleEnum`), for the SAME reason
+// `FileChangeRefSchema.kind` is: this schema feeds the openspec-generating
+// `SpecificationSchema`, and a NEW enum value-set would trip the openspec-parity
+// "no widening" guard (§7b a — openspec.schema.json stays additive-only, the
+// public-contract reconciliation is deferred to MP.6). The strict 5-role
+// constraint is enforced at the AUTHORING gate (the `ticket_step_actions`
+// node-verb payload, gate #2) via `FileRoleEnum`; `FileRole` types the values.
+export const StepFileSchema = z.object({
+    path: z.string(),
+    role: z.string(),
+    symbol: z.string().optional(),
+    why: z.string().optional(),
+});
+export const ImplementationStepSchema = z.object({
+    id: z.string(),
+    text: z.string(),
+    order: z.number().int().min(1),
+    // ME.19.2 (D17) — step-as-atom: the files this step touches, by role. The
+    // authoring source for the `TicketFileChange` rows + step↔file joins (both
+    // DERIVED from here). Optional (NO minCount — D17 guardrail 1).
+    files: z.array(StepFileSchema).optional(),
+    // MB.14.1/14.2 — step↔artifact link ids, hydrated from the 3 join models
+    // (TicketImplementationStepFile / …StepCodeSnippet / …StepTypeSnippet). These
+    // are INTERNAL recompose fields (not part of the published openspec.tech v1.1
+    // standard — same internal-divergence class as ticket.tags / snippet.order):
+    // additive + optional, so the openspec-parity enum guard is untouched. The
+    // MB.14.2 FK cross_validation checks read them; a `verification` ticket is exempt.
+    linkedFileIds: z.array(z.string()).optional(),
+    linkedCodeSnippetIds: z.array(z.string()).optional(),
+    linkedTypeSnippetIds: z.array(z.string()).optional(),
+});
+export const FileChangeRefSchema = z.object({
+    id: z.string(),
+    path: z.string(),
+    kind: z.string(),
+    // ME.19.2 (D17) — the step-file entry's optional coupled symbol + rationale, carried
+    // on the sidecar so the WORK orientation renders `path#symbol` and the whole-ticket
+    // roll-up keeps codeReferences.symbol / typeReferences.typeName + description.
+    symbol: z.string().optional(),
+    why: z.string().optional(),
+});
+export const TestTypeEnum = z.enum([
+    'unit', 'integration', 'e2e', 'typecheck', 'lint', 'build',
+    'contract', 'structural', 'layout', 'a11y', 'performance',
+]);
+// SHAPE-only: element types are validated here, but the CONTENT minimums
+// (testTypes/qualityGates ≥ 1) are NOT — they are a ticket_expansion, verification-
+// ticket-only RUBRIC concern (config:...arrayMinCounts.ticket.testSpecification.*).
+// Encoding `.min(1)` here made the global `checkFormat` shape gate reject a present-
+// but-empty testSpecification at ticket_decomposition (and on implementation tickets),
+// which the rubric would never have flagged. coverageTarget tolerates null (AppSync
+// returns absent columns as null, which `.optional()` alone rejects).
+export const TestSpecificationSchema = z.object({
+    testTypes: z.array(TestTypeEnum),
+    qualityGates: z.array(z.string()),
+    testCommands: z.array(z.string()),
+    coverageTarget: z.number().min(0).max(100).nullish(),
+});
+export const CodeReferenceSchema = z.object({
+    filePath: z.string(),
+    symbol: z.string().optional(),
+    description: z.string().optional(),
+});
+export const TypeReferenceSchema = z.object({
+    filePath: z.string(),
+    typeName: z.string(),
+    description: z.string().optional(),
+});
+export const CodeSnippetSchema = z.object({
+    id: z.string(),
+    language: z.string(),
+    description: z.string().optional(),
+    content: z.string(),
+    // TicketCodeSnippet.order is a.integer().required(); the decompose writes it.
+    order: z.number().int().nonnegative().optional(),
+    // ME.19 §7b (b) — a snippet MAY carry the file path it was drawn from. Purely
+    // OPTIONAL/internal-additive: when present it enters validation, when absent it
+    // is simply not validated (no minCount, no required).
+    sourcePath: z.string().optional(),
+});
+export const TypeSnippetSchema = z.object({
+    id: z.string(),
+    language: z.string(),
+    description: z.string().optional(),
+    content: z.string(),
+    // TicketTypeSnippet.order is a.integer().required(); the decompose writes it.
+    order: z.number().int().nonnegative().optional(),
+    // ME.19 §7b (b) — optional source path (see CodeSnippetSchema.sourcePath).
+    sourcePath: z.string().optional(),
+});
+export const BlueprintReferenceSchema = z.object({
+    blueprintId: z.string(),
+    // MB.9: `link_blueprint_to_tickets` is the SOLE writer and sets only blueprintId,
+    // so the recomposed ref carries `context`/`section` as NULL (AppSync stores unset
+    // optional fields as null, not undefined). `.optional()` alone rejects null
+    // ("Expected string, received null") — which made the ticket_decomposition
+    // blueprint-coverage gate unsatisfiable (surfaced by the MB.9 live-gate). These are
+    // optional annotations, so accept null too.
+    context: z.string().nullish(),
+    section: z.string().nullish(),
+});
+// ME.19 (D4 / B0) — the dependency-inversion origin flag SET, carried on the flat
+// lifecycle projection so `origin` reaches the engines that branch on it (validator's
+// D2 proposal filter + lifecycle's D16 delete-guard). spec-types cannot import api-types,
+// so the shape is declared here structurally (a plain `{provenance?, scaffold?, semantic?}`
+// object). Stays 3 flags — NO `concurrent` (the `#6` case is a live check, D21).
+export const DependencyOriginSchema = z.object({
+    provenance: z.boolean().optional(),
+    scaffold: z.boolean().optional(),
+    semantic: z.boolean().optional(),
+});
+export const DependencyLinkSchema = z.object({
+    ticketId: z.string(),
+    type: z.enum(['requires', 'blocks']),
+    // ME.19 (B0) — the persisted flag set (NOT re-derivable engine-side). Optional so every
+    // pre-ME.19 link (absent field) still parses; absent ⇒ AUTHORED.
+    origin: DependencyOriginSchema.optional(),
+});
+//# sourceMappingURL=auxiliary.js.map

package/node_modules/@specforge/spec-types/dist/schema/auxiliary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.js","sourceRoot":"","sources":["../../src/schema/auxiliary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,+EAA+E;AAC/E,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAG3F,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,2EAA2E;AAC3E,iFAAiF;AACjF,6EAA6E;AAC7E,yEAAyE;AACzE,0EAA0E;AAC1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,0EAA0E;IAC1E,2EAA2E;IAC3E,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACzC,yEAAyE;IACzE,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,mFAAmF;IACnF,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAiBH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,qFAAqF;IACrF,oFAAoF;IACpF,+EAA+E;IAC/E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO;IAC1D,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa;CAC1D,CAAC,CAAC;AAEH,yEAAyE;AACzE,oFAAoF;AACpF,oFAAoF;AACpF,qFAAqF;AACrF,uFAAuF;AACvF,oFAAoF;AACpF,sEAAsE;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAChC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE;CACrD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,8EAA8E;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAChD,8EAA8E;IAC9E,gFAAgF;IAChF,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,8EAA8E;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAChD,2EAA2E;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,kFAAkF;IAClF,kFAAkF;IAClF,4EAA4E;IAC5E,2EAA2E;IAC3E,oFAAoF;IACpF,4CAA4C;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;CAC9B,CAAC,CAAC;AAEH,kFAAkF;AAClF,sFAAsF;AACtF,0FAA0F;AAC1F,4FAA4F;AAC5F,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpC,wFAAwF;IACxF,iEAAiE;IACjE,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC"}

package/node_modules/@specforge/spec-types/dist/schema/blueprint.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export declare const BlueprintCategoryEnum: z.ZodEnum<["flowchart", "architecture", "state", "sequence", "erd", "mockup", "adr", "component", "deployment", "api", "algorithm", "protocol", "glossary", "design_system"]>;
+export declare const BlueprintFormatEnum: z.ZodEnum<["markdown", "mermaid", "ascii", "mixed", "html", "svg", "image"]>;
+export declare const BlueprintCoverageTypeEnum: z.ZodEnum<["ticket", "all"]>;
+export declare const BlueprintStatusEnum: z.ZodEnum<["draft", "review", "approved", "deprecated"]>;
+export type BlueprintStatus = z.infer<typeof BlueprintStatusEnum>;
+export declare const BlueprintSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    category: z.ZodEnum<["flowchart", "architecture", "state", "sequence", "erd", "mockup", "adr", "component", "deployment", "api", "algorithm", "protocol", "glossary", "design_system"]>;
+    format: z.ZodOptional<z.ZodEnum<["markdown", "mermaid", "ascii", "mixed", "html", "svg", "image"]>>;
+    coverageType: z.ZodDefault<z.ZodEnum<["ticket", "all"]>>;
+    content: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    order: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    title: string;
+    category: "flowchart" | "architecture" | "state" | "sequence" | "erd" | "mockup" | "adr" | "component" | "deployment" | "api" | "algorithm" | "protocol" | "glossary" | "design_system";
+    coverageType: "ticket" | "all";
+    order?: number | undefined;
+    description?: string | undefined;
+    slug?: string | undefined;
+    format?: "markdown" | "mermaid" | "ascii" | "mixed" | "html" | "svg" | "image" | undefined;
+    notes?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    id: string;
+    content: string;
+    title: string;
+    category: "flowchart" | "architecture" | "state" | "sequence" | "erd" | "mockup" | "adr" | "component" | "deployment" | "api" | "algorithm" | "protocol" | "glossary" | "design_system";
+    order?: number | undefined;
+    description?: string | undefined;
+    slug?: string | undefined;
+    format?: "markdown" | "mermaid" | "ascii" | "mixed" | "html" | "svg" | "image" | undefined;
+    coverageType?: "ticket" | "all" | undefined;
+    notes?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+//# sourceMappingURL=blueprint.d.ts.map

package/node_modules/@specforge/spec-types/dist/schema/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/schema/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB,+KAIhC,CAAC;AAKH,eAAO,MAAM,mBAAmB,8EAG9B,CAAC;AAEH,eAAO,MAAM,yBAAyB,8BAA4B,CAAC;AAKnE,eAAO,MAAM,mBAAmB,0DAAwD,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa1B,CAAC"}

package/node_modules/@specforge/spec-types/dist/schema/blueprint.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export const BlueprintCategoryEnum = z.enum([
+    'flowchart', 'architecture', 'state', 'sequence',
+    'erd', 'mockup', 'adr', 'component', 'deployment',
+    'api', 'algorithm', 'protocol', 'glossary', 'design_system',
+]);
+// The OpenSpec v1.1 blueprint format enum — the published standard at
+// openspec.tech/schema/v1.1 carries all 7 values. The SpecificationBlueprint.format
+// model + the deny-gate mirror it (full v1.1 compliance).
+export const BlueprintFormatEnum = z.enum([
+    'markdown', 'mermaid', 'ascii', 'mixed',
+    'html', 'svg', 'image',
+]);
+export const BlueprintCoverageTypeEnum = z.enum(['ticket', 'all']);
+// Runtime/model status vocabulary (the SpecificationBlueprint `status` column).
+// Canonical home so the ME.14.2 APS enum write-guard + the validator enum-parity
+// guard share one source with the AppSync model.
+export const BlueprintStatusEnum = z.enum(['draft', 'review', 'approved', 'deprecated']);
+export const BlueprintSchema = z.object({
+    id: z.string(),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    slug: z.string().optional(),
+    category: BlueprintCategoryEnum,
+    format: BlueprintFormatEnum.optional(),
+    coverageType: BlueprintCoverageTypeEnum.default('ticket'),
+    content: z.string(),
+    notes: z.string().optional(),
+    version: z.string().optional(),
+    order: z.number().int().nonnegative().optional(),
+    tags: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=blueprint.js.map

package/node_modules/@specforge/spec-types/dist/schema/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","sourceRoot":"","sources":["../../src/schema/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1C,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU;IAChD,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY;IACjD,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe;CAC5D,CAAC,CAAC;AAEH,sEAAsE;AACtE,oFAAoF;AACpF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;IACvC,MAAM,EAAE,KAAK,EAAE,OAAO;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnE,gFAAgF;AAChF,iFAAiF;AACjF,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AAGzF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACtC,YAAY,EAAE,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAChD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/node_modules/@specforge/spec-types/dist/schema/entity-field-schemas.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** The three entity kinds whose rows carry `a.json()` fields on the gate-check read. */
+export type SpecEntityKind = 'spec' | 'epic' | 'ticket';
+/**
+ * Per-field lenient schemas, keyed by entity. A field present in the read parser's
+ * canonical `a.json()` list but ABSENT here (`dependencyTree`, `statusHistory`) has
+ * no canonical schema — it is `JSON.parse`d but not schema-validated on read, and it
+ * carries no `id`, so `ensureItemIds` leaves it untouched.
+ */
+export declare const ENTITY_FIELD_SCHEMAS: Record<SpecEntityKind, Record<string, z.ZodTypeAny>>;
+/**
+ * Return a shallow copy of `fields` with the `a.json()` array-of-object fields of
+ * `entity` carrying a minted `id` (always) + positional `order` (only where the item
+ * schema has one, and only when the agent omitted it), RECURSIVELY (covers e.g.
+ * `spec.requirements[].acceptanceCriteria[]`).
+ *
+ * Policy (MB.1 decisions, locked 2026-07-08):
+ *  - `id` is INTERNAL identity, ALWAYS auto-minted (regenerated even if one is
+ *    present). The agent never sends it; the validator ignores it (these embedded ids
+ *    are NOT foreign keys — unlike ticket AC, which are separate entities). The agent
+ *    re-sends the whole array each update, so ids churn per write — that churn is inert
+ *    and accepted.
+ *  - `order` RESPECTS an agent-provided value; it is auto-filled by 1-based position
+ *    ONLY when absent.
+ *
+ * Never validates content, never throws. Non-array / unknown fields (and the whole
+ * `ticket` entity, whose sub-arrays are normalized into child tables that already
+ * stamp id+order — MB.1 §0.1) pass through verbatim.
+ *
+ * @param idGen deterministic id source for tests; defaults to `randomUUID`.
+ */
+export declare function ensureItemIds(fields: Record<string, unknown>, entity: SpecEntityKind, idGen?: () => string): Record<string, unknown>;
+//# sourceMappingURL=entity-field-schemas.d.ts.map

package/node_modules/@specforge/spec-types/dist/schema/entity-field-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-field-schemas.d.ts","sourceRoot":"","sources":["../../src/schema/entity-field-schemas.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoBxB,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAKxD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CA8BrF,CAAC;AAmFF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,MAAM,MAA2B,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}