phasegate 0.159.0 → 0.160.0

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.160.0] - 2026-05-13
+
+### Added
+
+- **WI-170 — phase2 initial-creation expiration public contract** — documents `p2:check-initial-creation` as a public compatibility command and adds schema/type support for `phase2Extensions.initialCreationExpirationRules` in v2 and v3 config documents.
+
 ## [0.159.0] - 2026-05-13
 
 ### Added

package/docs/guide/cli-reference.md

@@ -415,7 +415,7 @@ ISSUE-005 P3-10 で明確化された境界:
 | `p2:check-freshness` | `--pattern <glob>` `--dry-run` `--format text\|json` | Compatibility entry point for L4-004 doc freshness; canonical L4 execution is `validate --layer L4` |
 | `p2:validate-pointers` | `--include-urls` `--format text\|json` | Compatibility entry point for L4-005 pointer validation; canonical L4 execution is `validate --layer L4` |
 | `p2:generate-e2e-template` | `--phase <phase>` `--output <path>` | Generate E2E test template |
-| `p2:check-initial-creation` | `--pattern <glob>` `--format text\|json` | Compatibility detector for long-lived `initial_creation: true` docs. |
+| `p2:check-initial-creation` | `--pattern <glob>` `--format text\|json` | Public compatibility detector for long-lived `initial_creation: true` docs; configured by `phase2Extensions.initialCreationExpirationRules`. |
 
 ### `phasegate:generate-matrix`
 

package/docs/guide/configuration.md

@@ -75,6 +75,18 @@ The plan identifies target fields, managed artifacts, commands, validation, risk
   "baseline": {
     "enabled": true,
     "path": ".phasegate/baseline.json"
+  },
+  "phase2Extensions": {
+    "initialCreationExpirationRules": [
+      {
+        "ruleId": "stale-initial-creation",
+        "documentPattern": "docs/**/*.md",
+        "daysThreshold": 90,
+        "commitCountThreshold": 5,
+        "evaluationMode": "or",
+        "enabled": true
+      }
+    ]
   }
 }
 ```
@@ -179,6 +191,29 @@ Example for Python and TypeScript:
 
 The metadata validators read `@unit` and `@layer` with language-agnostic regular expressions, so Python `# @unit api` and Go `// @unit api` style comments are both valid as long as the file extension is included here.
 
+#### `phase2Extensions`
+
+<!-- @work-item-id WI-170 -->
+
+`phase2Extensions.initialCreationExpirationRules` is a public compatibility contract for `phasegate p2:check-initial-creation`. The command detects documents that still carry `traceability.initial_creation: true` after they have aged past configured thresholds. Regular scheduled drift checks should still run through `phasegate validate --layer L4`.
+
+| Sub-field | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `initialCreationExpirationRules` | `array` | built-in `90 days / 5 commits / or` rule | Rules used by `p2:check-initial-creation`. Omit to use the built-in rule. |
+
+Rule fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `ruleId` | `string` | Stable identifier shown in diagnostics. |
+| `documentPattern` | `string` | Glob for candidate Markdown documents. |
+| `daysThreshold` | `number` | Non-negative age threshold in days. |
+| `commitCountThreshold` | `number` | Non-negative threshold for the number of commits touching the document. |
+| `evaluationMode` | `"or"` \| `"and"` | `"or"` reports when either threshold is met; `"and"` requires both. |
+| `enabled` | `boolean` | Optional. Defaults to `true`. |
+
+Keep `initial_creation: true` only while a document is genuinely new and still being filled. Remove it once the expected initial content exists; otherwise this compatibility command reports the document after the configured age or commit-count threshold.
+
 ##### Phase Dependency Presets
 
 | Preset     | Phase 3 Gates | storyReflection default                                                 | Use Case                                           |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.159.0",
+  "version": "0.160.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/harness/config-foundation/domain/harness-config.ts

@@ -54,6 +54,7 @@ export interface HarnessConfigSourceDocument {
   ci?: HarnessConfigResolvedDocument['ci'];
   validate?: HarnessConfigResolvedDocument['validate'];
   preCommit?: Partial<HarnessConfigResolvedDocument['preCommit']>;
+  phase2Extensions?: HarnessConfigResolvedDocument['phase2Extensions'];
   architecture?: ArchitectureConfigSource;
 }
 
@@ -122,6 +123,16 @@ export interface HarnessConfigResolvedDocument {
   preCommit?: {
     implementationExtensions: string[];
   };
+  phase2Extensions?: {
+    initialCreationExpirationRules?: Array<{
+      ruleId: string;
+      documentPattern: string;
+      daysThreshold: number;
+      commitCountThreshold: number;
+      evaluationMode: 'or' | 'and';
+      enabled?: boolean;
+    }>;
+  };
   architecture?: ArchitectureConfigDocument;
 }
 

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

@@ -498,6 +498,55 @@
           "minLength": 1
         }
       }
+    },
+    "phase2Extensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "initialCreationExpirationRules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "ruleId",
+              "documentPattern",
+              "daysThreshold",
+              "commitCountThreshold",
+              "evaluationMode"
+            ],
+            "properties": {
+              "ruleId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "documentPattern": {
+                "type": "string",
+                "minLength": 1
+              },
+              "daysThreshold": {
+                "type": "number",
+                "minimum": 0
+              },
+              "commitCountThreshold": {
+                "type": "number",
+                "minimum": 0
+              },
+              "evaluationMode": {
+                "type": "string",
+                "enum": [
+                  "or",
+                  "and"
+                ]
+              },
+              "enabled": {
+                "type": "boolean"
+              }
+            }
+          },
+          "uniqueItems": true
+        }
+      }
     }
   }
 }

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

@@ -619,6 +619,55 @@
           "then": { "required": ["preset", "layers", "allowedDependencies"] }
         }
       ]
+    },
+    "phase2Extensions": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "initialCreationExpirationRules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "ruleId",
+              "documentPattern",
+              "daysThreshold",
+              "commitCountThreshold",
+              "evaluationMode"
+            ],
+            "properties": {
+              "ruleId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "documentPattern": {
+                "type": "string",
+                "minLength": 1
+              },
+              "daysThreshold": {
+                "type": "number",
+                "minimum": 0
+              },
+              "commitCountThreshold": {
+                "type": "number",
+                "minimum": 0
+              },
+              "evaluationMode": {
+                "type": "string",
+                "enum": [
+                  "or",
+                  "and"
+                ]
+              },
+              "enabled": {
+                "type": "boolean"
+              }
+            }
+          },
+          "uniqueItems": true
+        }
+      }
     }
   }
 }

package/scripts/harness/main.ts

@@ -221,7 +221,7 @@ Commands:
   p2:check-freshness             Check doc freshness (--pattern <glob>, --dry-run, --format text|json)
   p2:validate-pointers           Validate doc pointers (--include-urls, --format text|json)
   p2:generate-e2e-template       Generate E2E test template (--phase <phase>, --output <path>)
-  p2:check-initial-creation      Detect long-lived initial_creation:true docs (--pattern <glob>, --format text|json)
+  p2:check-initial-creation      Public compatibility detector for long-lived initial_creation:true docs (--pattern <glob>, --format text|json)
   hook <pre-tool-use|post-tool-use|stop|session-start|user-prompt-submit>  Run agent hook (reads JSON from stdin; writes JSON to stdout for session-start/user-prompt-submit)
   pre-commit                              Run L2 pre-commit validators on staged files
   commit-msg <message-file>               Validate commit message trailers against staged files