phasegate 0.91.0 → 0.108.0

package/scripts/harness/config-foundation/infrastructure/schemas/harness-config-v3.schema.json

@@ -0,0 +1,546 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "project",
+    "layers",
+    "quickMode",
+    "phaseDependencies",
+    "planningMode",
+    "harnesses",
+    "paths",
+    "reporting"
+  ],
+  "properties": {
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "preset"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "preset": {
+          "type": "string",
+          "enum": [
+            "minimal",
+            "standard",
+            "strict"
+          ]
+        },
+        "paths": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "source": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "minLength": 1
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "docs": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "construction": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "inception": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "layers": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "L0": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "validators": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            }
+          }
+        },
+        "L1": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "rules": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "L2": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "validators": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            }
+          }
+        },
+        "L3": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "validators": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            },
+            "coverageThreshold": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100
+            }
+          }
+        },
+        "L4": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "validators": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "uniqueItems": true
+            },
+            "schedule": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    },
+    "quickMode": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allowedCategories": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "maintainedLayers": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "relaxedGates": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "uniqueItems": true
+        },
+        "fullModeRequiredWhen": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mixedCategories": {
+              "type": "boolean"
+            },
+            "newDomainFile": {
+              "type": "boolean"
+            },
+            "apiContractChange": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
+    "phaseDependencies": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "preset"
+      ],
+      "properties": {
+        "preset": {
+          "type": "string",
+          "enum": [
+            "default",
+            "full",
+            "standard",
+            "minimal",
+            "custom"
+          ]
+        },
+        "override": {
+          "type": "boolean"
+        },
+        "customRules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "phase",
+              "requires"
+            ],
+            "properties": {
+              "phase": {
+                "type": "string",
+                "minLength": 1
+              },
+              "requires": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "gates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "level",
+              "requires",
+              "blocks",
+              "dependsOn"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9-]*$"
+              },
+              "level": {
+                "type": "integer",
+                "enum": [
+                  1,
+                  2,
+                  3
+                ]
+              },
+              "requires": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "path",
+                    "required"
+                  ],
+                  "properties": {
+                    "path": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "required": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              },
+              "blocks": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "dependsOn": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9-]*$"
+                }
+              },
+              "storyAnnotation": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "required",
+                  "tag"
+                ],
+                "properties": {
+                  "required": {
+                    "type": "boolean"
+                  },
+                  "tag": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              }
+            },
+            "allOf": [
+              {
+                "if": {
+                  "required": [
+                    "storyAnnotation"
+                  ]
+                },
+                "then": {
+                  "properties": {
+                    "level": {
+                      "const": 3
+                    }
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "storyReflection": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "mappings": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "unitId",
+                  "artifacts"
+                ],
+                "properties": {
+                  "unitId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "artifacts": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "minLength": 1
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "planningMode": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "default",
+        "perPhase"
+      ],
+      "properties": {
+        "default": {
+          "type": "string",
+          "enum": [
+            "interactive",
+            "embedded-qa"
+          ]
+        },
+        "perPhase": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "enum": [
+              "interactive",
+              "embedded-qa"
+            ]
+          }
+        }
+      }
+    },
+    "harnesses": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "agentLessonCollection": {
+          "type": "boolean"
+        },
+        "cascadeUpdate": {
+          "type": "boolean"
+        },
+        "bundleSizeLimit": {
+          "type": "number",
+          "minimum": 0
+        },
+        "deadCodeGC": {
+          "type": "boolean"
+        }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "designDocs",
+        "inceptionDocs"
+      ],
+      "properties": {
+        "designDocs": {
+          "type": "string",
+          "minLength": 1
+        },
+        "inceptionDocs": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "reporting": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "format",
+        "outputDir"
+      ],
+      "properties": {
+        "format": {
+          "type": "string",
+          "minLength": 1
+        },
+        "outputDir": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "protectedFiles": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "exclude": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "uniqueItems": true
+        }
+      }
+    },
+    "baseline": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "architecture": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["preset"],
+      "properties": {
+        "preset": {
+          "type": "string",
+          "enum": ["clean", "strict-ddd", "onion", "hexagonal", "layered", "flat", "custom"]
+        },
+        "layers": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$",
+            "minLength": 1
+          },
+          "uniqueItems": true,
+          "minItems": 1
+        },
+        "allowedDependencies": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z][a-z0-9-]*$"
+            },
+            "uniqueItems": true
+          }
+        },
+        "metadataTags": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "layer": {
+              "type": "string",
+              "pattern": "^@[a-z][a-zA-Z0-9]*$"
+            },
+            "unit": {
+              "type": "string",
+              "pattern": "^@[a-z][a-zA-Z0-9]*$"
+            }
+          }
+        },
+        "layerDetection": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "byPath": { "type": "boolean" },
+            "byTag": { "type": "boolean" }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "preset": { "const": "custom" } }, "required": ["preset"] },
+          "then": { "required": ["preset", "layers", "allowedDependencies"] }
+        }
+      ]
+    }
+  }
+}

package/scripts/harness/config-foundation/infrastructure/validators/ajv-config-schema-validator.ts

@@ -18,19 +18,28 @@ type HarnessErrorWithPath = HarnessError & {
 };
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SCHEMA_PATH = path.resolve(__dirname, '../schemas/harness-config-v2.schema.json');
+const SCHEMA_V2_PATH = path.resolve(__dirname, '../schemas/harness-config-v2.schema.json');
+const SCHEMA_V3_PATH = path.resolve(__dirname, '../schemas/harness-config-v3.schema.json');
 
-function loadSchema(): object {
-  const raw = fs.readFileSync(SCHEMA_PATH, 'utf8');
+function loadSchemaFromPath(schemaPath: string): object {
+  const raw = fs.readFileSync(schemaPath, 'utf8');
   return JSON.parse(raw) as object;
 }
 
-function createValidateFunction(): ValidateFunction {
+function createValidateFunction(schemaPath: string): ValidateFunction {
   const ajv = new Ajv({
     allErrors: true,
   });
 
-  return ajv.compile(loadSchema());
+  return ajv.compile(loadSchemaFromPath(schemaPath));
+}
+
+function detectSchemaVersion(document: unknown): 'v2' | 'v3' {
+  if (typeof document === 'object' && document !== null && 'architecture' in document) {
+    return 'v3';
+  }
+
+  return 'v2';
 }
 
 function buildPath(error: ErrorObject): string {
@@ -100,10 +109,13 @@ function toHarnessError(error: ErrorObject): HarnessErrorWithPath {
   });
 }
 
-const validateSchema = createValidateFunction();
+const validateSchemaV2 = createValidateFunction(SCHEMA_V2_PATH);
+const validateSchemaV3 = createValidateFunction(SCHEMA_V3_PATH);
 
 export class AjvConfigSchemaValidator implements ConfigSchemaValidatorPort {
   validate(document: unknown): readonly HarnessError[] {
+    const schemaVersion = detectSchemaVersion(document);
+    const validateSchema = schemaVersion === 'v3' ? validateSchemaV3 : validateSchemaV2;
     const valid = validateSchema(document);
 
     if (valid) {

package/scripts/harness/config-foundation/presentation/cli/migrate-schema-command-handler.ts

@@ -0,0 +1,83 @@
+/**
+ * @layer presentation
+ * @unit config-foundation
+ *
+ * `phasegate migrate --schema v3` のハンドラー。
+ * phasegate.config.json に `architecture` キーが無い v2 config を検出したら
+ * `architecture: { preset: "clean" }` を追記して v3 化する。既に v3 の場合は no-op。
+ */
+
+import type { MigrateSchemaOutput } from '../../application/usecases/migrate-schema-use-case.js';
+
+export interface MigrateSchemaCommandInput {
+  readonly targetVersion: string;
+  readonly configPath?: string;
+}
+
+export interface MigrateSchemaCommandOutput {
+  readonly exitCode: number;
+  readonly output: string;
+}
+
+export interface MigrateSchemaPort {
+  execute(input: {
+    targetVersion: 'v3';
+    configPath?: string;
+  }): Promise<Readonly<MigrateSchemaOutput>>;
+}
+
+export interface MigrateSchemaCommandHandlerDeps {
+  readonly migrateSchemaUseCase: MigrateSchemaPort;
+}
+
+export class MigrateSchemaCommandHandler {
+  private readonly migrateSchemaUseCase: MigrateSchemaPort;
+
+  constructor(deps: MigrateSchemaCommandHandlerDeps) {
+    this.migrateSchemaUseCase = deps.migrateSchemaUseCase;
+  }
+
+  async execute(
+    input: MigrateSchemaCommandInput,
+  ): Promise<MigrateSchemaCommandOutput> {
+    if (input.targetVersion !== 'v3') {
+      return {
+        exitCode: 2,
+        output:
+          `Error: unsupported --schema version "${input.targetVersion}". Only "v3" is supported.`,
+      };
+    }
+
+    try {
+      const result = await this.migrateSchemaUseCase.execute({
+        targetVersion: 'v3',
+        configPath: input.configPath,
+      });
+
+      if (result.alreadyUpToDate) {
+        return {
+          exitCode: 0,
+          output: `✓ ${result.configPath} is already schema v3 (architecture key present). No changes applied.`,
+        };
+      }
+
+      const changes = result.appliedChanges.map((c) => `  - ${c}`).join('\n');
+      return {
+        exitCode: 0,
+        output: [
+          `✓ Migrated ${result.configPath} to schema v3.`,
+          'Applied changes:',
+          changes,
+          '',
+          '補足: `architecture.preset` の既定値は "clean"。onion / hexagonal / layered / flat 等を採用している場合は手動で変更してください（docs/guide/preset-selection.md 参照）。',
+        ].join('\n'),
+      };
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        exitCode: 1,
+        output: `Error: ${message}`,
+      };
+    }
+  }
+}