Support microcompact ISO TTL durations

Author: SqlRush

docs/cc-100-roadmap.md

@@ -54,6 +54,8 @@ M6 补充：microcompact disk cache loader 现在会把 `value` 字段中的 tex
 
 M6 补充：microcompact disk cache loader 的 relative TTL 现在接受分钟、小时和天级字段别名，包括 `ttlMinutes`、`expiresInHours`、`validForDays` 及 snake/camel 相邻形式，恢复 cached microcompact 过期时间时不再只依赖秒/毫秒字段。
 
+M6 补充：microcompact disk cache loader 的 relative TTL 字符串现在接受固定单位 ISO-8601 duration，例如 `PT1H30M`、`P1D`、`P1DT2H`，同时仍拒绝年/月这类长度不固定的 duration，避免 cache expiry 产生歧义。
+
 M6 补充：sidechain/subagent lifecycle state loader 现在接受 `subagent_started`、`agentStarted`、`task_failed`、`sidechainCompleted` 等相邻 subtype aliases，支持 `taskID`/`workerId`/`runId`、`agentName`/`kind`、`resultText`/`finalMessage` 等字段，并在 failed/cancelled subtype 没有显式 status 时自动归一状态。
 
 M6 补充：sidechain/subagent lifecycle content 读取现在接受 JSON:API/resource-style `resource`/`attributes`/`properties` wrapper，外层 resource `id` 可作为 sidechain ID fallback，内层 agent metadata、status/outcome 和 summary 字段仍能恢复到 state/list/resume。

docs/claude-code-go-rewrite-plan.md

@@ -293,6 +293,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：microcompact disk cache loader 现在接受 `cacheEntry`/`cache_entry`、`micro_compact`/`micro_compact_result` wrapper，以及 `summaryMarkdown`/`resultSummary`/`compressedText`、`cacheDigest`/`digestHash`/`fingerprint`、`summarizedCount`/`retainedCount`、`formatVersion` 和 `ttlMilliseconds`/`expiresInMilliseconds`/`maxAgeMilliseconds` 等相邻实现字段别名。
 - 本轮补充：microcompact disk cache loader 继续接受相邻 timestamp/expiry aliases，包括 `cachedAt`、`cacheCreatedAt`、`storedAt`、`generatedAt`、`updatedAt`、`timestamp`、`expiry`、`expirationTime`、`validUntil`、`notAfter`，以及 `timeToLiveSeconds`、`validForMs` 等相对 TTL 字段。
 - 本轮补充：microcompact disk cache loader 的相对 TTL 现在也接受分钟、小时和天级别名，例如 `ttlMinutes`、`expiresInHours`、`validForDays` 及 snake/camel 相邻形式，恢复 cached microcompact 过期时间时不再局限于秒/毫秒。
+- 本轮补充：microcompact disk cache loader 的相对 TTL 字符串现在也接受固定单位 ISO-8601 duration，例如 `PT1H30M`、`P1D`、`P1DT2H`，并继续拒绝年/月这类不定长 duration。
 - 本轮补充：microcompact disk cache loader 和 prune 现在接受 digest 缺失但文件名已 keyed 的 cache entry，会用 `<digest>.json` 文件名作为 digest fallback，同时仍保留显式 digest mismatch 的 invalid-cache guard。
 - 本轮补充：microcompact disk cache loader 的 `cached`/`fromCache`/`cacheHit`/`isCached` 布尔字段现在接受 JSON bool、`true`/`false`、`yes`/`no`、`on`/`off` 和 `1`/`0` 数字/字符串形态。
 - 本轮补充：microcompact disk cache loader 现在会从 `metadata`/`meta`/`cacheInfo`/`cacheDetails`/`cacheEntry`/`entry`/`record`/`cache` 等 sidecar object 中补缺失的 digest、version、cache-hit、timestamp、TTL 和 count aliases；主 summary payload 字段仍保持优先。

docs/first-second-parity-audit.md

@@ -127,6 +127,7 @@ M6 progress now includes:
 - `internal/compact`: microcompact disk cache loading also accepts adjacent cache-entry wrappers and aliases such as `cacheEntry`/`cache_entry`, `micro_compact`/`micro_compact_result`, `summaryMarkdown`/`resultSummary`/`compressedText`, `cacheDigest`/`digestHash`/`fingerprint`, `summarizedCount`/`retainedCount`, `formatVersion`, and millisecond TTL aliases such as `ttlMilliseconds`, `expiresInMilliseconds`, and `maxAgeMilliseconds`.
 - `internal/compact`: microcompact disk cache loading now also accepts adjacent timestamp aliases such as `cachedAt`, `cacheCreatedAt`, `storedAt`, `generatedAt`, `updatedAt`, `timestamp`, `expiry`, `expirationTime`, `validUntil`, `notAfter`, and relative TTL aliases such as `timeToLiveSeconds` and `validForMs`.
 - `internal/compact`: microcompact disk cache relative TTL loading now also accepts minute, hour, and day aliases such as `ttlMinutes`, `expiresInHours`, and `validForDays`, including adjacent snake/camel forms.
+- `internal/compact`: microcompact disk cache relative TTL strings now also accept fixed-unit ISO-8601 durations such as `PT1H30M`, `P1D`, and `P1DT2H`, while rejecting ambiguous year/month durations.
 - `internal/compact`: microcompact disk cache loading now fills missing cache metadata from sidecar objects such as `metadata`, `meta`, `cacheInfo`, `cacheDetails`, `cacheEntry`, `entry`, `record`, and `cache`, preserving primary result fields while recovering digest/version/cache-hit/timestamp/TTL/count aliases stored outside the summary payload.
 - `internal/compact`: microcompact disk cache loading and pruning now use the `<digest>.json` filename as a digest fallback when a cache entry omits an internal digest, while preserving explicit digest mismatch pruning/errors.
 - `internal/compact`: microcompact disk cache loading now accepts non-strict cache-hit booleans for `cached`/`fromCache`/`cacheHit`/`isCached`, including `yes`/`no`, `on`/`off`, and `1`/`0` JSON number or string values.

internal/compact/compact_test.go

@@ -423,6 +423,71 @@ func TestLoadMicroResultAcceptsMinuteHourDayTTLAliases(t *testing.T) {
 	}
 }
 
+func TestLoadMicroResultAcceptsISO8601TTLDurations(t *testing.T) {
+	cacheDir := filepath.Join(t.TempDir(), "micro")
+	if err := os.MkdirAll(cacheDir, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	for _, tc := range []struct {
+		digest string
+		field  string
+		want   time.Duration
+	}{
+		{digest: "ttl-iso-hours-minutes", field: `"ttl":"PT1H30M"`, want: 90 * time.Minute},
+		{digest: "expires-iso-day-hours", field: `"expiresIn":"P1DT2H"`, want: 26 * time.Hour},
+		{digest: "valid-iso-minutes", field: `"validFor":"PT45M"`, want: 45 * time.Minute},
+	} {
+		payload := fmt.Sprintf(`{
+			"summary": %q,
+			"digest": %q,
+			"version": "microcompact.v1",
+			"createdAt": 100,
+			%s
+		}`, tc.digest+" summary", tc.digest, tc.field)
+		if err := os.WriteFile(microResultPath(cacheDir, tc.digest), []byte(payload), 0o600); err != nil {
+			t.Fatal(err)
+		}
+		result, ok, err := LoadMicroResult(cacheDir, tc.digest)
+		if err != nil {
+			t.Fatalf("%s load error: %v", tc.digest, err)
+		}
+		if !ok {
+			t.Fatalf("%s was not loaded", tc.digest)
+		}
+		if want := time.Unix(100, 0).UTC().Add(tc.want); !result.ExpiresAt.Equal(want) {
+			t.Fatalf("%s expires_at = %s, want %s", tc.digest, result.ExpiresAt, want)
+		}
+	}
+}
+
+func TestLoadMicroResultRejectsAmbiguousISO8601TTLDurations(t *testing.T) {
+	cacheDir := filepath.Join(t.TempDir(), "micro")
+	if err := os.MkdirAll(cacheDir, 0o755); err != nil {
+		t.Fatal(err)
+	}
+	for _, tc := range []struct {
+		digest string
+		field  string
+	}{
+		{digest: "ttl-iso-month", field: `"ttl":"P1M"`},
+		{digest: "ttl-iso-year", field: `"ttl":"P1Y"`},
+	} {
+		payload := fmt.Sprintf(`{
+			"summary": %q,
+			"digest": %q,
+			"version": "microcompact.v1",
+			"createdAt": 100,
+			%s
+		}`, tc.digest+" summary", tc.digest, tc.field)
+		if err := os.WriteFile(microResultPath(cacheDir, tc.digest), []byte(payload), 0o600); err != nil {
+			t.Fatal(err)
+		}
+		if _, _, err := LoadMicroResult(cacheDir, tc.digest); err == nil {
+			t.Fatalf("%s loaded ambiguous ISO-8601 TTL", tc.digest)
+		}
+	}
+}
+
 func TestLoadMicroResultAcceptsWrappedCacheObjects(t *testing.T) {
 	cacheDir := filepath.Join(t.TempDir(), "micro")
 	if err := os.MkdirAll(cacheDir, 0o755); err != nil {

internal/compact/micro.go

@@ -884,6 +884,9 @@ func microParseJSONDuration(raw json.RawMessage, field string) (time.Duration, e
 		if duration, err := time.ParseDuration(text); err == nil {
 			return duration, nil
 		}
+		if duration, ok := microParseISO8601Duration(text); ok {
+			return duration, nil
+		}
 		number, err := strconv.ParseFloat(text, 64)
 		if err != nil {
 			return 0, err
@@ -903,6 +906,71 @@ func microParseJSONDuration(raw json.RawMessage, field string) (time.Duration, e
 	return 0, fmt.Errorf("invalid duration field %q", field)
 }
 
+func microParseISO8601Duration(text string) (time.Duration, bool) {
+	value := strings.ToUpper(strings.TrimSpace(text))
+	if len(value) < 2 || value[0] != 'P' {
+		return 0, false
+	}
+	value = value[1:]
+	inTime := false
+	total := 0.0
+	for value != "" {
+		if value[0] == 'T' {
+			if inTime {
+				return 0, false
+			}
+			inTime = true
+			value = value[1:]
+			continue
+		}
+		index := strings.IndexFunc(value, func(r rune) bool {
+			return !((r >= '0' && r <= '9') || r == '.')
+		})
+		if index <= 0 {
+			return 0, false
+		}
+		number, err := strconv.ParseFloat(value[:index], 64)
+		if err != nil {
+			return 0, false
+		}
+		unit := value[index]
+		switch unit {
+		case 'W':
+			if inTime {
+				return 0, false
+			}
+			total += number * float64(7*24*time.Hour)
+		case 'D':
+			if inTime {
+				return 0, false
+			}
+			total += number * float64(24*time.Hour)
+		case 'H':
+			if !inTime {
+				return 0, false
+			}
+			total += number * float64(time.Hour)
+		case 'M':
+			if !inTime {
+				return 0, false
+			}
+			total += number * float64(time.Minute)
+		case 'S':
+			if !inTime {
+				return 0, false
+			}
+			total += number * float64(time.Second)
+		default:
+			return 0, false
+		}
+		value = value[index+1:]
+	}
+	if total <= 0 {
+		return 0, false
+	}
+	return time.Duration(total), true
+}
+
 func microDurationFromFloat(value float64, field string) time.Duration {
 	if microDurationFieldIsMillis(field) {
 		return time.Duration(value * float64(time.Millisecond))