legacymaxxing 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+import { z } from "zod";
+/** Every persisted record carries `schemaVersion` so reads stay forward-compatible. */
+export declare const artifactKindSchema: z.ZodEnum<{
+    json: "json";
+    md: "md";
+    mermaid: "mermaid";
+    html: "html";
+    dir: "dir";
+    patch: "patch";
+}>;
+export declare const phaseStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    running: "running";
+    produced: "produced";
+    validated: "validated";
+    failed: "failed";
+    "gate-approved": "gate-approved";
+    "gate-rejected": "gate-rejected";
+}>;
+export type PhaseStatus = z.infer<typeof phaseStatusSchema>;
+export declare const configRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    provider: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ConfigRecord = z.infer<typeof configRecordSchema>;
+export declare const systemEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    legacyPath: z.ZodString;
+    baseSha: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type SystemEntry = z.infer<typeof systemEntrySchema>;
+export declare const projectRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    systems: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        legacyPath: z.ZodString;
+        baseSha: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProjectRecord = z.infer<typeof projectRecordSchema>;
+export declare const phaseArtifactSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        json: "json";
+        md: "md";
+        mermaid: "mermaid";
+        html: "html";
+        dir: "dir";
+        patch: "patch";
+    }>;
+    present: z.ZodBoolean;
+    valid: z.ZodBoolean;
+}, z.core.$strip>;
+export type PhaseArtifact = z.infer<typeof phaseArtifactSchema>;
+export declare const gateSchema: z.ZodObject<{
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    note: z.ZodNullable<z.ZodString>;
+    decidedAt: z.ZodString;
+}, z.core.$strip>;
+export type Gate = z.infer<typeof gateSchema>;
+export declare const phaseRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    system: z.ZodString;
+    phase: z.ZodEnum<{
+        assess: "assess";
+        map: "map";
+        extract: "extract";
+        brief: "brief";
+        transform: "transform";
+        reimagine: "reimagine";
+        harden: "harden";
+    }>;
+    status: z.ZodEnum<{
+        pending: "pending";
+        running: "running";
+        produced: "produced";
+        validated: "validated";
+        failed: "failed";
+        "gate-approved": "gate-approved";
+        "gate-rejected": "gate-rejected";
+    }>;
+    artifacts: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            json: "json";
+            md: "md";
+            mermaid: "mermaid";
+            html: "html";
+            dir: "dir";
+            patch: "patch";
+        }>;
+        present: z.ZodBoolean;
+        valid: z.ZodBoolean;
+    }, z.core.$strip>>;
+    runId: z.ZodNullable<z.ZodString>;
+    baseSha: z.ZodNullable<z.ZodString>;
+    gate: z.ZodNullable<z.ZodObject<{
+        decision: z.ZodEnum<{
+            approve: "approve";
+            reject: "reject";
+        }>;
+        note: z.ZodNullable<z.ZodString>;
+        decidedAt: z.ZodString;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type PhaseRecord = z.infer<typeof phaseRecordSchema>;
+export declare const runRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    system: z.ZodString;
+    phase: z.ZodEnum<{
+        assess: "assess";
+        map: "map";
+        extract: "extract";
+        brief: "brief";
+        transform: "transform";
+        reimagine: "reimagine";
+        harden: "harden";
+    }>;
+    provider: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    mutating: z.ZodBoolean;
+    startedAt: z.ZodString;
+    finishedAt: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        running: "running";
+        failed: "failed";
+        ok: "ok";
+    }>;
+    droppedArtifacts: z.ZodNumber;
+    summary: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type RunRecord = z.infer<typeof runRecordSchema>;
+/** The single shape the model is asked to emit at the end of each phase. */
+export declare const phaseOutputArtifactSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        json: "json";
+        md: "md";
+        mermaid: "mermaid";
+        html: "html";
+        dir: "dir";
+        patch: "patch";
+    }>;
+}, z.core.$strip>;
+export type PhaseOutputArtifact = z.infer<typeof phaseOutputArtifactSchema>;
+export declare const phaseOutputSchema: z.ZodObject<{
+    summary: z.ZodString;
+    artifacts: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            json: "json";
+            md: "md";
+            mermaid: "mermaid";
+            html: "html";
+            dir: "dir";
+            patch: "patch";
+        }>;
+    }, z.core.$strip>>;
+    notes: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PhaseOutput = z.infer<typeof phaseOutputSchema>;

package/dist/types.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { PHASE_NAMES } from "./phases.js";
+/** Every persisted record carries `schemaVersion` so reads stay forward-compatible. */
+export const artifactKindSchema = z.enum(["md", "mermaid", "json", "html", "dir", "patch"]);
+export const phaseStatusSchema = z.enum([
+    "pending",
+    "running",
+    "produced",
+    "validated",
+    "failed",
+    "gate-approved",
+    "gate-rejected",
+]);
+export const configRecordSchema = z.object({
+    schemaVersion: z.literal(1),
+    provider: z.string(),
+    model: z.string().nullable(),
+});
+export const systemEntrySchema = z.object({
+    name: z.string(),
+    legacyPath: z.string(),
+    baseSha: z.string().nullable(),
+    createdAt: z.string(),
+});
+export const projectRecordSchema = z.object({
+    schemaVersion: z.literal(1),
+    systems: z.array(systemEntrySchema),
+});
+export const phaseArtifactSchema = z.object({
+    path: z.string(),
+    kind: artifactKindSchema,
+    present: z.boolean(),
+    valid: z.boolean(),
+});
+export const gateSchema = z.object({
+    decision: z.enum(["approve", "reject"]),
+    note: z.string().nullable(),
+    decidedAt: z.string(),
+});
+export const phaseRecordSchema = z.object({
+    schemaVersion: z.literal(1),
+    system: z.string(),
+    phase: z.enum(PHASE_NAMES),
+    status: phaseStatusSchema,
+    artifacts: z.array(phaseArtifactSchema),
+    runId: z.string().nullable(),
+    baseSha: z.string().nullable(),
+    gate: gateSchema.nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const runRecordSchema = z.object({
+    schemaVersion: z.literal(1),
+    runId: z.string(),
+    system: z.string(),
+    phase: z.enum(PHASE_NAMES),
+    provider: z.string(),
+    model: z.string().nullable(),
+    mutating: z.boolean(),
+    startedAt: z.string(),
+    finishedAt: z.string().nullable(),
+    status: z.enum(["running", "ok", "failed"]),
+    droppedArtifacts: z.number(),
+    summary: z.string().nullable(),
+});
+/** The single shape the model is asked to emit at the end of each phase. */
+export const phaseOutputArtifactSchema = z.object({
+    path: z.string(),
+    kind: artifactKindSchema,
+});
+export const phaseOutputSchema = z.object({
+    summary: z.string(),
+    artifacts: z.array(phaseOutputArtifactSchema),
+    notes: z.string().nullable(),
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "legacymaxxing",
+  "version": "0.1.0",
+  "description": "A loop CLI that guides an AI agent (Codex first) through the code-modernization lifecycle: assess → map → extract → brief → transform/reimagine → harden, with gated mutation and persisted, resumable state.",
+  "license": "MIT",
+  "bin": {
+    "legacymaxxing": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.64.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/postbuild.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint . --config oxlint.json",
+    "format": "oxfmt --write .",
+    "format:check": "oxfmt --check .",
+    "test": "vitest run",
+    "pack:smoke": "node scripts/package-smoke.mjs"
+  }
+}