@momentiq/dark-factory-cli 2.0.0 → 2.2.0

package/dist/onboard/scaffold-schema.d.ts

@@ -0,0 +1,194 @@
+import { z } from "zod";
+export declare const SCAFFOLD_PLAN_SCHEMA_VERSION: 1;
+export declare const SOURCE_ANALYSIS_SCHEMA_VERSION: 1;
+export declare const SCAFFOLD_PLAN_BYTE_BUDGET = 64512;
+export declare const FILE_PLAN_CONTENT_CAP = 16384;
+export declare const SCAFFOLD_PLAN_FILES_CAP = 100;
+export declare const SCAFFOLD_PLAN_SUMMARY_CAP = 800;
+declare const EmitPlan: z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"emit">;
+    rationale: z.ZodString;
+    tailored_content: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "emit";
+    rationale: string;
+    tailored_content: string;
+}, {
+    path: string;
+    action: "emit";
+    rationale: string;
+    tailored_content: string;
+}>;
+declare const MergePlan: z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"merge">;
+    rationale: z.ZodString;
+    tailored_content: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "merge";
+    rationale: string;
+    tailored_content: string;
+}, {
+    path: string;
+    action: "merge";
+    rationale: string;
+    tailored_content: string;
+}>;
+declare const SkipPlan: z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"skip">;
+    rationale: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "skip";
+    rationale: string;
+}, {
+    path: string;
+    action: "skip";
+    rationale: string;
+}>;
+export declare const FilePlanSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"emit">;
+    rationale: z.ZodString;
+    tailored_content: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "emit";
+    rationale: string;
+    tailored_content: string;
+}, {
+    path: string;
+    action: "emit";
+    rationale: string;
+    tailored_content: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"merge">;
+    rationale: z.ZodString;
+    tailored_content: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "merge";
+    rationale: string;
+    tailored_content: string;
+}, {
+    path: string;
+    action: "merge";
+    rationale: string;
+    tailored_content: string;
+}>, z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodLiteral<"skip">;
+    rationale: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "skip";
+    rationale: string;
+}, {
+    path: string;
+    action: "skip";
+    rationale: string;
+}>]>;
+export declare const ScaffoldPlanSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sourceAnalysisSchemaVersion: z.ZodLiteral<1>;
+    templateRef: z.ZodEffects<z.ZodString, string, string>;
+    generatedAtIso: z.ZodString;
+    files: z.ZodArray<z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+        path: z.ZodString;
+        action: z.ZodLiteral<"emit">;
+        rationale: z.ZodString;
+        tailored_content: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        action: "emit";
+        rationale: string;
+        tailored_content: string;
+    }, {
+        path: string;
+        action: "emit";
+        rationale: string;
+        tailored_content: string;
+    }>, z.ZodObject<{
+        path: z.ZodString;
+        action: z.ZodLiteral<"merge">;
+        rationale: z.ZodString;
+        tailored_content: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        action: "merge";
+        rationale: string;
+        tailored_content: string;
+    }, {
+        path: string;
+        action: "merge";
+        rationale: string;
+        tailored_content: string;
+    }>, z.ZodObject<{
+        path: z.ZodString;
+        action: z.ZodLiteral<"skip">;
+        rationale: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        action: "skip";
+        rationale: string;
+    }, {
+        path: string;
+        action: "skip";
+        rationale: string;
+    }>]>, "many">;
+    summary: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    summary: string;
+    files: ({
+        path: string;
+        action: "emit";
+        rationale: string;
+        tailored_content: string;
+    } | {
+        path: string;
+        action: "merge";
+        rationale: string;
+        tailored_content: string;
+    } | {
+        path: string;
+        action: "skip";
+        rationale: string;
+    })[];
+    sourceAnalysisSchemaVersion: 1;
+    templateRef: string;
+    generatedAtIso: string;
+}, {
+    schemaVersion: 1;
+    summary: string;
+    files: ({
+        path: string;
+        action: "emit";
+        rationale: string;
+        tailored_content: string;
+    } | {
+        path: string;
+        action: "merge";
+        rationale: string;
+        tailored_content: string;
+    } | {
+        path: string;
+        action: "skip";
+        rationale: string;
+    })[];
+    sourceAnalysisSchemaVersion: 1;
+    templateRef: string;
+    generatedAtIso: string;
+}>;
+export type ScaffoldPlan = z.infer<typeof ScaffoldPlanSchema>;
+export type FilePlan = z.infer<typeof FilePlanSchema>;
+export type EmitFilePlan = z.infer<typeof EmitPlan>;
+export type MergeFilePlan = z.infer<typeof MergePlan>;
+export type SkipFilePlan = z.infer<typeof SkipPlan>;
+export {};
+//# sourceMappingURL=scaffold-schema.d.ts.map

package/dist/onboard/scaffold-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-schema.d.ts","sourceRoot":"","sources":["../../src/onboard/scaffold-schema.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AACvD,eAAO,MAAM,8BAA8B,EAAG,CAAU,CAAC;AACzD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;EAKH,CAAC;AAEZ,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;EAKJ,CAAC;AAEZ,QAAA,MAAM,QAAQ;;;;;;;;;;;;EAIH,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIzB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/onboard/scaffold-schema.js

@@ -0,0 +1,73 @@
+// packages/cli/src/onboard/scaffold-schema.ts
+//
+// ScaffoldPlan — Stage B output envelope (cycle 15 Phase B).
+//
+// The LLM (Stage B) consumes a RepoAnalysis (Phase A) + a sage-blueprint
+// template directory and emits a ScaffoldPlan: per-file action decisions
+// (emit | merge | skip) with rationale and (for emit/merge) the tailored
+// body content. Discriminated union on `action` makes the LLM tool-call
+// shape unambiguous and Zod-rejects mixed states.
+//
+// Budget contract: serialized ScaffoldPlan ≤ 64 KB; per-file tailored_content
+// ≤ 16 KB; files[] ≤ 100. Per-file cap + files cap together bound the LLM
+// context AND the writer cost.
+import { z } from "zod";
+import { parseTemplateRef, TEMPLATE_REF_SHAPE_RE } from "./template-ref.js";
+export const SCAFFOLD_PLAN_SCHEMA_VERSION = 1;
+export const SOURCE_ANALYSIS_SCHEMA_VERSION = 1;
+export const SCAFFOLD_PLAN_BYTE_BUDGET = 64_512;
+export const FILE_PLAN_CONTENT_CAP = 16_384;
+export const SCAFFOLD_PLAN_FILES_CAP = 100;
+export const SCAFFOLD_PLAN_SUMMARY_CAP = 800;
+const EmitPlan = z.object({
+    path: z.string().min(1).max(512),
+    action: z.literal("emit"),
+    rationale: z.string().min(1).max(800),
+    tailored_content: z.string().max(FILE_PLAN_CONTENT_CAP),
+}).strict();
+const MergePlan = z.object({
+    path: z.string().min(1).max(512),
+    action: z.literal("merge"),
+    rationale: z.string().min(1).max(800),
+    tailored_content: z.string().max(FILE_PLAN_CONTENT_CAP),
+}).strict();
+const SkipPlan = z.object({
+    path: z.string().min(1).max(512),
+    action: z.literal("skip"),
+    rationale: z.string().min(1).max(800),
+}).strict();
+export const FilePlanSchema = z.discriminatedUnion("action", [
+    EmitPlan,
+    MergePlan,
+    SkipPlan,
+]);
+export const ScaffoldPlanSchema = z.object({
+    schemaVersion: z.literal(SCAFFOLD_PLAN_SCHEMA_VERSION),
+    sourceAnalysisSchemaVersion: z.literal(SOURCE_ANALYSIS_SCHEMA_VERSION),
+    templateRef: z
+        .string()
+        .regex(TEMPLATE_REF_SHAPE_RE, {
+        message: "templateRef must match gh:<owner>/<repo>@<ref> or file:///<abs-path>@<ref>",
+    })
+        .refine((s) => {
+        try {
+            parseTemplateRef(s);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, (s) => {
+        try {
+            parseTemplateRef(s);
+            return { message: "(unreachable — refine should have passed)" };
+        }
+        catch (e) {
+            return { message: e instanceof Error ? e.message : String(e) };
+        }
+    }),
+    generatedAtIso: z.string().datetime({ offset: false }),
+    files: z.array(FilePlanSchema).max(SCAFFOLD_PLAN_FILES_CAP),
+    summary: z.string().max(SCAFFOLD_PLAN_SUMMARY_CAP),
+}).strict();
+//# sourceMappingURL=scaffold-schema.js.map

package/dist/onboard/scaffold-schema.js.map

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