@codedrifters/configulator 0.0.301 → 0.0.302

package/lib/index.js

@@ -246,6 +246,10 @@ __export(index_exports, {
   DEFAULT_STATE_FILE_PATH: () => DEFAULT_STATE_FILE_PATH,
   DEFAULT_STATUS_LABELS: () => DEFAULT_STATUS_LABELS,
   DEFAULT_TEARDOWN_BRANCH_PATTERNS: () => DEFAULT_TEARDOWN_BRANCH_PATTERNS,
+  DEFAULT_TEMPORAL_FRAMING_CADENCES: () => DEFAULT_TEMPORAL_FRAMING_CADENCES,
+  DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER: () => DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER,
+  DEFAULT_TEMPORAL_FRAMING_ENABLED: () => DEFAULT_TEMPORAL_FRAMING_ENABLED,
+  DEFAULT_TEMPORAL_FRAMING_PATHS: () => DEFAULT_TEMPORAL_FRAMING_PATHS,
   DEFAULT_TYPE_LABELS: () => DEFAULT_TYPE_LABELS,
   DEFAULT_UNBLOCK_COMMENT_TEMPLATE: () => DEFAULT_UNBLOCK_COMMENT_TEMPLATE,
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED: () => DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
@@ -277,6 +281,7 @@ __export(index_exports, {
   SUPPRESSED_WORKFLOW_RULE_NAMES: () => SUPPRESSED_WORKFLOW_RULE_NAMES,
   SampleLang: () => SampleLang,
   StarlightProject: () => StarlightProject,
+  TEMPORAL_FRAMING_CATEGORY_VALUES: () => TEMPORAL_FRAMING_CATEGORY_VALUES,
   TIER_AWARE_BUNDLE_NAMES: () => TIER_AWARE_BUNDLE_NAMES,
   TestRunner: () => TestRunner,
   TsDocCoverageKind: () => TsDocCoverageKind,
@@ -400,6 +405,8 @@ __export(index_exports, {
   renderSkillEvalsRunnerScript: () => renderSkillEvalsRunnerScript,
   renderSourceTierExamples: () => renderSourceTierExamples,
   renderStubIndexConventionRuleContent: () => renderStubIndexConventionRuleContent,
+  renderTemporalFramingCheckerScript: () => renderTemporalFramingCheckerScript,
+  renderTemporalFramingRuleContent: () => renderTemporalFramingRuleContent,
   renderUnblockDependentsScript: () => renderUnblockDependentsScript,
   renderUnblockDependentsSection: () => renderUnblockDependentsSection,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
@@ -425,6 +432,7 @@ __export(index_exports, {
   resolveSharedEditing: () => resolveSharedEditing,
   resolveSkillEvals: () => resolveSkillEvals,
   resolveTemplateVariables: () => resolveTemplateVariables,
+  resolveTemporalFraming: () => resolveTemporalFraming,
   resolveTypeScriptProjectOutdir: () => resolveTypeScriptProjectOutdir,
   resolveUnblockDependents: () => resolveUnblockDependents,
   runScan: () => runScan,
@@ -446,6 +454,7 @@ __export(index_exports, {
   validateSharedEditingConfig: () => validateSharedEditingConfig,
   validateSkillEvalsConfig: () => validateSkillEvalsConfig,
   validateStarlightSingleton: () => validateStarlightSingleton,
+  validateTemporalFramingConfig: () => validateTemporalFramingConfig,
   validateUnblockDependentsConfig: () => validateUnblockDependentsConfig,
   vitestBundle: () => vitestBundle
 });
@@ -3177,6 +3186,457 @@ function renderStubIndexConventionRuleContent() {
   ].join("\n");
 }
 
+// src/agent/bundles/temporal-framing.ts
+var DEFAULT_TEMPORAL_FRAMING_ENABLED = true;
+var DEFAULT_TEMPORAL_FRAMING_PATHS = [
+  "docs/src/content/docs/profiles/**/*.md",
+  "docs/src/content/docs/industry-research/**/*.md",
+  "docs/src/content/docs/software-research/**/*.md",
+  "docs/src/content/docs/regulatory-research/**/*.md",
+  "docs/src/content/docs/standards-research/**/*.md",
+  "docs/src/content/docs/customer-research/**/*.md"
+];
+var TEMPORAL_FRAMING_CATEGORY_VALUES = [
+  "ownership",
+  "company-leadership",
+  "regulatory-status",
+  "litigation",
+  "dated-metrics"
+];
+var DEFAULT_TEMPORAL_FRAMING_CADENCES = {
+  ownership: 180,
+  "company-leadership": 90,
+  "regulatory-status": 30,
+  litigation: 30,
+  "dated-metrics": 180
+};
+var DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER = false;
+function resolveTemporalFraming(config) {
+  const paths = config?.paths ?? DEFAULT_TEMPORAL_FRAMING_PATHS;
+  assertValidPaths(paths);
+  const cadences = resolveCadences(config?.cadences);
+  return {
+    enabled: config?.enabled ?? DEFAULT_TEMPORAL_FRAMING_ENABLED,
+    paths,
+    cadences,
+    emitChecker: config?.emitChecker ?? DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER
+  };
+}
+function validateTemporalFramingConfig(config) {
+  return resolveTemporalFraming(config);
+}
+function renderTemporalFramingRuleContent(tf) {
+  if (!tf.enabled) {
+    return [
+      "# Temporal Framing Convention",
+      "",
+      "**Temporal framing is not enforced in this project.** Agents are",
+      "not required to add `as of [date]` qualifiers to time-sensitive",
+      "claims, and refresh passes do not use a mechanical grep to find",
+      "stale framing. Staleness is caught by review and downstream user",
+      "reports alone.",
+      "",
+      "Enable the convention via",
+      "`AgentConfigOptions.temporalFraming.enabled = true`."
+    ].join("\n");
+  }
+  const lines = [
+    "# Temporal Framing Convention",
+    "",
+    "Every factual claim that can change over time MUST carry an inline",
+    "`as of [YYYY-MM-DD]` or `as of [Month YYYY]` qualifier on the",
+    "**first** occurrence of the claim in the document. Once qualified",
+    "once, subsequent references to the same fact in the same document",
+    "do not need to repeat the qualifier \u2014 the first qualifier governs",
+    "the document's snapshot date for that fact.",
+    "",
+    "The qualifier is mechanical, not editorial. Refresh agents grep",
+    "for `as of ` to find the time-bounded claims; without the",
+    "qualifier, a refresh pass has no cheap way to tell stale framing",
+    "from stable facts.",
+    "",
+    "## What counts as time-sensitive",
+    "",
+    "A claim is time-sensitive (and must carry the qualifier) when it",
+    "describes a state that **a single public event could invalidate",
+    "within the document's expected refresh cadence**. Five recurring",
+    "categories cover the common cases:",
+    "",
+    "| Category | Examples |",
+    "|----------|----------|",
+    '| **Ownership and investors** | "co-owned by X, Y, Z"; "majority-owned by"; "minority stake held by"; cap table; current investor lists |',
+    '| **Leadership tenure** | "X is CEO"; "X chairs the committee"; "X serves as"; current board chair; current executive team |',
+    '| **Regulatory or rule status** | "is in force"; "under public consultation"; "pending finalization"; "currently enjoined"; "under active investigation" |',
+    '| **Litigation and enforcement** | "is under active scrutiny"; "investigation is ongoing"; "appeal is pending"; "consent decree remains in effect" |',
+    '| **Pricing, valuation, and metrics** | "valued at $XB"; "annual revenue ~$X"; "processes N transactions"; "serves N customers" \u2014 when the figure is sourced from a dated press release or filing |',
+    "",
+    "A claim is **not** time-sensitive (and does not need the qualifier)",
+    "when it describes a historical event, a statutory text, or a",
+    "structural fact that does not change without amendment. Examples",
+    "that are safe without a qualifier:",
+    "",
+    '- "Acquired by Advent International in May 2019" (a dated historical event \u2014 the date itself is the anchor)',
+    '- "21 CFR Part 11 establishes criteria for electronic records" (statutory text)',
+    '- "Headquartered in Dallas, Texas" (changes only on a documented move)',
+    '- "Founded in 1999" (a one-time event)',
+    "",
+    "## Format",
+    "",
+    "Two acceptable forms:",
+    "",
+    "```markdown",
+    "As of May 2026, Acme is owned by ...",
+    "... Acme's CEO (as of May 2026) is ...",
+    "```",
+    "",
+    "Use the granularity that matches the source citation:",
+    "",
+    "- `as of YYYY-MM-DD` when the source is a specific filing, press release, or court order with a precise date.",
+    "- `as of Month YYYY` when the source is a self-reported page (e.g., a company's `About` page) where only the month-of-snapshot is meaningful.",
+    "- Do **not** write `as of 2026` (year-only) \u2014 that's too coarse to drive a refresh decision.",
+    "",
+    "## Examples",
+    "",
+    "### Wrong \u2014 present-tense framing of a state that can change",
+    "",
+    "```markdown",
+    "Availity is co-owned by major Blue Cross Blue Shield plans",
+    "(HCSC, Elevance Health/Anthem, BCBS Minnesota), Francisco",
+    "Partners, Novo Holdings, and Prettybrook Partners.",
+    "```",
+    "",
+    "This claim might have been true at a specific date but goes stale",
+    "as soon as any one investor exits. A refresh agent has no",
+    "mechanical signal that the claim is time-sensitive.",
+    "",
+    "### Right \u2014 explicit qualifier on the first claim",
+    "",
+    "```markdown",
+    "As of May 2026, Availity is co-owned by a mix of health plan",
+    "strategic investors (HCSC, Elevance Health/Anthem, BCBS",
+    "Minnesota, Humana, GuideWell) and financial sponsors (Novo",
+    "Holdings, Prettybrook Partners).",
+    "```",
+    "",
+    "The `as of May 2026` anchors the document's snapshot for the",
+    "ownership claim. Subsequent references to Availity's ownership in",
+    "the same document inherit that snapshot date.",
+    "",
+    "## When the convention applies",
+    "",
+    "The rule applies to every Markdown document any agent writes under",
+    "the following path globs:",
+    "",
+    ...tf.paths.map((p) => `- \`${p}\``),
+    "",
+    "It does **not** apply to:",
+    "",
+    "- Meeting notes (`meetings/**`) \u2014 the meeting date itself is the implicit `as of` anchor.",
+    "- Requirement documents (`requirements/**`) \u2014 formal requirements are versioned and dated via their own frontmatter.",
+    "- The project context page (`project-context.md`) \u2014 maintained as a living snapshot under direct human review.",
+    "",
+    "## Refresh-agent behaviour",
+    "",
+    "A refresh pass on any covered document MUST:",
+    "",
+    "1. Grep for `as of ` (case-insensitive) in the document.",
+    "2. For each qualifier, compute `today - <qualifier-date>` in days.",
+    "3. Classify each qualified claim against the category-specific",
+    "   cadence table below.",
+    "4. Re-verify every claim whose qualifier is older than its cadence.",
+    "5. Update the qualifier to today's date on every re-verified claim",
+    "   that remains accurate.",
+    "6. Treat documents that omit qualifiers entirely as needing",
+    "   **back-fill** before any other verification is attempted \u2014 the",
+    "   absence of qualifiers is itself a refresh finding.",
+    "",
+    "### Refresh cadence table",
+    "",
+    "Each category carries its own refresh cadence in days. Faster-decay",
+    "claims (regulatory status, litigation) refresh more often;",
+    "slower-decay claims (ownership, dated metrics) refresh less often.",
+    "",
+    "| Category | Cadence (days) |",
+    "|----------|----------------|",
+    `| \`ownership\` | ${tf.cadences.ownership} |`,
+    `| \`company-leadership\` | ${tf.cadences["company-leadership"]} |`,
+    `| \`regulatory-status\` | ${tf.cadences["regulatory-status"]} |`,
+    `| \`litigation\` | ${tf.cadences.litigation} |`,
+    `| \`dated-metrics\` | ${tf.cadences["dated-metrics"]} |`,
+    "",
+    "Consumers may override any subset of cadences via",
+    "`AgentConfigOptions.temporalFraming.cadences`. Unspecified",
+    "categories fall through to the defaults above."
+  ];
+  if (tf.emitChecker) {
+    lines.push(
+      "",
+      "## Lint",
+      "",
+      "The bundled `.claude/procedures/check-temporal-framing.sh` helper",
+      "enforces the rule mechanically. Given a set of changed files (as",
+      "positional arguments or a newline-separated list on stdin), it",
+      "fails non-zero when any file matches a configured path glob and",
+      "carries time-sensitive framing without an `as of ` qualifier.",
+      "",
+      "```bash",
+      "# Pre-commit (staged files):",
+      "git diff --cached --name-only \\",
+      "  | .claude/procedures/check-temporal-framing.sh",
+      "",
+      "# CI (branch-vs-base):",
+      "git diff --name-only origin/main...HEAD \\",
+      "  | .claude/procedures/check-temporal-framing.sh",
+      "```",
+      "",
+      "The lint is a coarse signal \u2014 it flags files that look",
+      "time-sensitive but carry no qualifier. Authors and reviewers are",
+      "still expected to validate that each qualifier is correctly",
+      "anchored to its source citation."
+    );
+  }
+  lines.push(
+    "",
+    "## Out of scope",
+    "",
+    "- Auto-generating qualifiers from source-citation dates. Authors",
+    "  read the source and write the qualifier explicitly.",
+    "- Replacing existing dated frontmatter conventions. Frontmatter",
+    "  `date:` fields anchor the document's overall snapshot; the",
+    "  inline qualifier anchors individual time-sensitive claims so a",
+    "  refresh pass can re-verify them without re-reading the whole",
+    "  document.",
+    "- Back-filling pre-existing documents in bulk. Refresh passes",
+    "  back-fill qualifiers on the documents they touch; bulk",
+    "  back-fill is a downstream consumer cleanup task, not a",
+    "  configulator change."
+  );
+  return lines.join("\n");
+}
+function renderTemporalFramingCheckerScript(tf) {
+  const patternsLiteral = tf.paths.map((p) => `  ${JSON.stringify(p)}`).join("\n");
+  return [
+    "#!/usr/bin/env bash",
+    "# check-temporal-framing.sh \u2014 Enforce the temporal-framing convention.",
+    "#",
+    "# Usage:",
+    "#   .claude/procedures/check-temporal-framing.sh <file>...",
+    "#   git diff --name-only HEAD | .claude/procedures/check-temporal-framing.sh",
+    "#",
+    "# Fails non-zero when any changed file matches a configured path",
+    "# pattern AND contains present-tense framing of a time-sensitive",
+    "# claim category AND does NOT carry an `as of ` qualifier anywhere",
+    "# in the file. The lint is file-level, not line-level \u2014 the cheap",
+    "# coarse signal is enough to catch the failure mode the convention",
+    "# targets, and a finer-grained check would carry too much false",
+    "# positive cost.",
+    "#",
+    "# The path patterns are rendered from the consumer's",
+    "# TemporalFramingConfig at synth time \u2014 do not edit by hand;",
+    "# regenerate via `pnpm exec projen`.",
+    "#",
+    "# Patterns support the `**` recursive-segment wildcard even though",
+    "# bash's native `[[ $file == $glob ]]` pattern matching does not:",
+    "# each glob is converted to a POSIX-extended regex internally and",
+    "# matched with `=~`, so the script works uniformly on bash 3.2",
+    "# (macOS default) and bash 4+ (Linux / CI).",
+    "",
+    "set -uo pipefail",
+    "",
+    "err() {",
+    '  printf "check-temporal-framing.sh: %s\\n" "$*" >&2',
+    "}",
+    "",
+    "# Path glob patterns. Translated to anchored POSIX-extended regexes",
+    "# at runtime by `glob_to_regex` below so `**` matches recursively",
+    "# across path segments.",
+    "path_patterns=(",
+    patternsLiteral,
+    ")",
+    "",
+    "# Triggers \u2014 present-tense framing keywords that indicate a",
+    "# time-sensitive claim category. Match is case-insensitive and",
+    "# whole-word; the keyword list is deliberately small (one or two",
+    "# canonical phrases per category) to keep false positives low.",
+    "triggers=(",
+    '  "is owned by"',
+    '  "co-owned by"',
+    '  "majority-owned by"',
+    '  "minority-owned by"',
+    '  "is co-owned"',
+    '  "is currently"',
+    '  "currently chairs"',
+    '  "currently serves"',
+    '  "is in force"',
+    '  "under public consultation"',
+    '  "under active investigation"',
+    '  "is pending"',
+    '  "investigation is ongoing"',
+    ")",
+    "",
+    "# Convert a bash-style glob into an anchored POSIX-extended regex:",
+    "#   **/   \u2192 (.+/)?   (zero or more path segments plus trailing slash)",
+    "#   **    \u2192 .*       (anywhere, including `/`)",
+    "#   *     \u2192 [^/]*    (single path segment)",
+    "#   ?     \u2192 [^/]     (single non-slash char)",
+    "glob_to_regex() {",
+    '  local glob="$1"',
+    '  local regex=""',
+    "  local i=0",
+    "  local len=${#glob}",
+    "  while (( i < len )); do",
+    '    local c="${glob:i:1}"',
+    '    if [[ "$c" == "*" ]]; then',
+    '      local next="${glob:i+1:1}"',
+    '      if [[ "$next" == "*" ]]; then',
+    '        local after="${glob:i+2:1}"',
+    '        if [[ "$after" == "/" ]]; then',
+    '          regex+="(.+/)?"',
+    "          i=$((i+3))",
+    "          continue",
+    "        fi",
+    '        regex+=".*"',
+    "        i=$((i+2))",
+    "        continue",
+    "      fi",
+    '      regex+="[^/]*"',
+    "      i=$((i+1))",
+    "      continue",
+    "    fi",
+    '    if [[ "$c" == "?" ]]; then',
+    '      regex+="[^/]"',
+    "      i=$((i+1))",
+    "      continue",
+    "    fi",
+    '    case "$c" in',
+    "      .|+|\\(|\\)|\\[|\\]|\\{|\\}|\\||\\^|\\$|\\\\)",
+    '        regex+="\\\\$c"',
+    "        ;;",
+    "      *)",
+    '        regex+="$c"',
+    "        ;;",
+    "    esac",
+    "    i=$((i+1))",
+    "  done",
+    '  printf "^%s$" "$regex"',
+    "}",
+    "",
+    "# Check whether $file matches any of the configured path patterns.",
+    "# Returns 0 on match, 1 otherwise.",
+    "matches_any_pattern() {",
+    '  local file="$1"',
+    "  local pattern regex",
+    '  for pattern in "${path_patterns[@]}"; do',
+    '    regex=$(glob_to_regex "$pattern")',
+    '    if [[ "$file" =~ $regex ]]; then',
+    "      return 0",
+    "    fi",
+    "  done",
+    "  return 1",
+    "}",
+    "",
+    "# Check whether $file contains any present-tense framing trigger",
+    "# without an `as of ` qualifier anywhere in the file. Returns 0",
+    "# when the file is OK (no triggers, or triggers + qualifier), 1",
+    "# when the file is malformed (triggers + no qualifier).",
+    "file_ok() {",
+    '  local file="$1"',
+    '  [[ ! -f "$file" ]] && return 0',
+    "  local found_trigger=0",
+    "  local trigger",
+    '  for trigger in "${triggers[@]}"; do',
+    '    if grep -qi -- "$trigger" "$file"; then',
+    "      found_trigger=1",
+    "      break",
+    "    fi",
+    "  done",
+    "  if [[ $found_trigger -eq 0 ]]; then",
+    "    return 0",
+    "  fi",
+    '  if grep -qi -- "as of " "$file"; then',
+    "    return 0",
+    "  fi",
+    "  return 1",
+    "}",
+    "",
+    "# Read the file list from positional args or stdin.",
+    "files=()",
+    "if [[ $# -gt 0 ]]; then",
+    '  files=("$@")',
+    "else",
+    "  while IFS= read -r line; do",
+    '    [[ -n "$line" ]] && files+=("$line")',
+    "  done",
+    "fi",
+    "",
+    "if [[ ${#files[@]} -eq 0 ]]; then",
+    "  exit 0",
+    "fi",
+    "",
+    "violations=0",
+    'for file in "${files[@]}"; do',
+    '  if ! matches_any_pattern "$file"; then',
+    "    continue",
+    "  fi",
+    '  if ! file_ok "$file"; then',
+    '    err "$file: contains time-sensitive framing without an \\"as of\\" qualifier"',
+    "    violations=$((violations+1))",
+    "  fi",
+    "done",
+    "",
+    "if [[ $violations -gt 0 ]]; then",
+    '  err "found $violations file(s) violating the temporal-framing convention"',
+    "  exit 1",
+    "fi",
+    "exit 0"
+  ].join("\n");
+}
+function assertValidPaths(paths) {
+  if (!Array.isArray(paths)) {
+    throw new Error(
+      `TemporalFramingConfig.paths must be an array; got ${typeof paths}`
+    );
+  }
+  for (let i = 0; i < paths.length; i++) {
+    const entry = paths[i];
+    if (typeof entry !== "string" || entry.trim().length === 0) {
+      throw new Error(
+        `TemporalFramingConfig.paths[${i}] must be a non-empty string; got ${JSON.stringify(
+          entry
+        )}`
+      );
+    }
+  }
+}
+function resolveCadences(supplied) {
+  const merged = {
+    ...DEFAULT_TEMPORAL_FRAMING_CADENCES
+  };
+  if (supplied !== void 0) {
+    for (const category of TEMPORAL_FRAMING_CATEGORY_VALUES) {
+      const value = supplied[category];
+      if (value === void 0) {
+        continue;
+      }
+      assertValidCadence(value, category);
+      merged[category] = value;
+    }
+  }
+  return merged;
+}
+function assertValidCadence(value, field) {
+  if (typeof value !== "number" || !Number.isInteger(value)) {
+    throw new Error(
+      `TemporalFramingConfig.cadences.${field} must be a positive integer; got ${value}`
+    );
+  }
+  if (value <= 0) {
+    throw new Error(
+      `TemporalFramingConfig.cadences.${field} must be a positive integer; got ${value}`
+    );
+  }
+}
+
 // src/agent/bundles/base.ts
 var createPackageSkill = {
   name: "create-package",
@@ -4286,6 +4746,16 @@ function buildBaseBundle(paths = DEFAULT_AGENT_PATHS) {
         },
         tags: ["workflow"]
       },
+      {
+        name: "temporal-framing-convention",
+        description: "Temporal-framing convention: every agent-authored time-sensitive factual claim (ownership, leadership tenure, regulatory status, litigation, dated metrics) carries an inline `as of [YYYY-MM-DD]` or `as of [Month YYYY]` qualifier on first occurrence so refresh agents have a mechanical signal for which claims to re-verify.",
+        scope: AGENT_RULE_SCOPE.ALWAYS,
+        content: renderTemporalFramingRuleContent(resolveTemporalFraming()),
+        platforms: {
+          cursor: { exclude: true }
+        },
+        tags: ["workflow"]
+      },
       {
         name: "skill-evals",
         description: "Skill eval harness contract: declarative prompt/expected-output regression suites per skill at `<skillsRoot>/<skill-name>/evals/evals.json`, parameterised by a shared product-context fixture so the same eval shape works across every configulator-consuming project without forking fixtures.",
@@ -6529,19 +6999,29 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "   - <source URL> \u2014 <date accessed>",
       "   ```",
       "",
-      "4. **Decide whether a follow-up issue is warranted.** Create a",
+      "4. **Apply the `temporal-framing-convention` rule.** Every",
+      "   time-sensitive factual claim in the profile \u2014 ownership,",
+      "   leadership tenure, regulatory status, litigation, dated metrics",
+      "   \u2014 must carry an inline `as of [YYYY-MM-DD]` or `as of [Month",
+      "   YYYY]` qualifier on its **first** occurrence in the document.",
+      "   Use the granularity that matches the source citation (precise",
+      "   date for a filing or press release; month for a self-reported",
+      "   `About` page). The qualifier is mechanical, not editorial \u2014 it",
+      "   is the signal Phase 5 (Refresh) uses to grep for stale claims.",
+      "",
+      "5. **Decide whether a follow-up issue is warranted.** Create a",
       "   `company:followup` issue (depending on this draft issue) only if",
       "   the profile lists at least one follow-up candidate. Otherwise,",
       "   note in the draft issue's closing comment that no follow-up is",
       "   needed.",
       "",
-      "5. **File a `company:match` issue** (depending on this draft issue)",
+      "6. **File a `company:match` issue** (depending on this draft issue)",
       "   so the profile gets enriched against the project's business-model",
       "   canvases. Skip the match issue only when the invoking project has",
       "   no business-model canvases at all (Phase 4 will detect and exit",
       "   gracefully in that case).",
       "",
-      "6. **Commit and push** the profile file. Close the draft issue.",
+      "7. **Commit and push** the profile file. Close the draft issue.",
       "",
       "---",
       "",
@@ -6780,26 +7260,51 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "   the issue body does not set `force: true`, close the issue with",
       "   a short comment and stop \u2014 do not burn the search budget.",
       "",
-      "3. **Run 4\u20136 targeted searches.** Focus on:",
+      "3. **Grep for `as of ` qualifiers.** Per the",
+      "   `temporal-framing-convention` rule, every time-sensitive claim in",
+      "   the profile carries an inline `as of [YYYY-MM-DD]` or `as of",
+      "   [Month YYYY]` qualifier. Build the list of qualified claims and",
+      "   compute the age (in days) of each one against today's date.",
+      "   Classify each claim against the cadence table in the",
+      "   `temporal-framing-convention` rule:",
+      "   - **company-leadership** \u2014 90 days",
+      "   - **regulatory-status** \u2014 30 days",
+      "   - **litigation** \u2014 30 days",
+      "   - **ownership** \u2014 180 days",
+      "   - **dated-metrics** \u2014 180 days",
+      "",
+      "   Treat every qualifier older than its category's cadence as a",
+      "   re-verification target for the targeted-search step below. If the",
+      "   profile contains **no** `as of ` qualifiers at all, treat the",
+      "   entire profile as needing **back-fill** \u2014 apply the convention to",
+      "   every time-sensitive claim before running the targeted searches.",
+      "",
+      "4. **Run 4\u20136 targeted searches.** Focus on the categories surfaced by",
+      "   the qualifier grep (step 3), plus any additional signals worth a",
+      "   refresh:",
       "   - `<company name>` + recent news, press releases, or blog posts",
       "   - Product launches, feature changes, or pricing updates",
       "   - Funding rounds, acquisitions, or material ownership changes",
       "   - Leadership changes (CEO, CTO, CPO, notable departures/arrivals)",
       "   - New partnerships, certifications, or regulatory milestones",
       "",
-      "4. **Update the profile in place.** Edit the affected sections with",
+      "5. **Update the profile in place.** Edit the affected sections with",
       "   the new information. Cite every new claim. Preserve the slug and",
       "   the original `parent_issue` field. Bump the `date` frontmatter to",
-      "   today's date.",
+      "   today's date. **Update the `as of` qualifier** on every claim you",
+      "   re-verified \u2014 change the date to today's date when the claim",
+      "   still holds; rewrite the framing when the claim has changed.",
+      "   Surface unverifiable or stale-and-changed claims through",
+      "   `## Risks / Open Questions` rather than silently dropping them.",
       "",
-      "5. **Do not silently re-type the company.** If the refresh surfaces",
+      "6. **Do not silently re-type the company.** If the refresh surfaces",
       "   evidence that the company's primary type has changed (e.g., an",
       "   industry-player that now sells a directly competing product),",
       "   flag it in `## Risks / Open Questions` and stop \u2014 do **not**",
       "   rewrite the `company_type` frontmatter without an explicit",
       "   override in the refresh issue body (`retype: <new type>`).",
       "",
-      "6. **Append a revision-history row.** Summarize the delta in one",
+      "7. **Append a revision-history row.** Summarize the delta in one",
       "   line:",
       "",
       "   ```markdown",
@@ -6814,14 +7319,14 @@ function buildCompanyProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "   | YYYY-MM-DD | Refreshed: no material change |",
       "   ```",
       "",
-      "7. **Update reference entries** (if the project tracks company",
+      "8. **Update reference entries** (if the project tracks company",
       "   references under research directories). If the company's",
       "   relevance to a research area has shifted \u2014 for example, it is no",
       "   longer a live competitor, or it now plays in a new segment \u2014",
       "   update the corresponding entry under `referencedIn` and the",
       "   research-area doc that links to this profile.",
       "",
-      "8. **Commit and push.** Close the refresh issue with a short comment",
+      "9. **Commit and push.** Close the refresh issue with a short comment",
       "   summarizing the delta (or `no material change`).",
       "",
       "---",
@@ -15750,6 +16255,17 @@ function buildPeopleProfileAnalystSubAgent(paths, issueDefaults, tier) {
       "full background, and do not rewrite the profile body for facts that",
       "have not changed.",
       "",
+      "**Temporal framing.** Refreshes follow the same grep-`as of `-and-",
+      "re-verify pattern documented for `company:refresh` in the",
+      "`company-profile-analyst` bundle (Phase 5, steps 3 and 5): build",
+      "the list of qualified claims, classify each against the cadence",
+      "table in the `temporal-framing-convention` rule (90d for current",
+      "role / employer / tenure, falling back to 180d for slower-decay",
+      "claims), re-verify every claim past cadence, and update the",
+      "qualifier date on every claim that still holds. Treat a profile",
+      "with no `as of ` qualifiers as needing back-fill before any other",
+      "verification.",
+      "",
       "### Steps",
       "",
       "1. **Read the existing profile** at the path referenced in the issue",
@@ -29452,6 +29968,17 @@ var AgentConfig = class _AgentConfig extends import_projen8.Component {
         });
       }
     }
+    const resolvedTemporalFraming = validateTemporalFramingConfig(
+      this.options.temporalFraming
+    );
+    if (resolvedTemporalFraming.enabled && resolvedTemporalFraming.emitChecker) {
+      new import_projen8.TextFile(this, ".claude/procedures/check-temporal-framing.sh", {
+        lines: renderTemporalFramingCheckerScript(
+          resolvedTemporalFraming
+        ).split("\n"),
+        executable: true
+      });
+    }
     const platforms = this.resolvePlatforms();
     const rules = this.resolveRules();
     const skills = this.resolveSkills();
@@ -29799,6 +30326,23 @@ ${hook}`
         });
       }
     }
+    const resolvedTemporalFramingForRules = resolveTemporalFraming(
+      this.options.temporalFraming
+    );
+    if (this.options.temporalFraming) {
+      const temporalFramingRule = ruleMap.get("temporal-framing-convention");
+      if (temporalFramingRule) {
+        const temporalFramingContent = renderTemporalFramingRuleContent(
+          resolvedTemporalFramingForRules
+        );
+        if (temporalFramingContent !== temporalFramingRule.content) {
+          ruleMap.set("temporal-framing-convention", {
+            ...temporalFramingRule,
+            content: temporalFramingContent
+          });
+        }
+      }
+    }
     const tierExamples = this.options.features?.sourceTierExamples;
     if (_AgentConfig.hasActiveTierExamples(tierExamples)) {
       const sourceRule = ruleMap.get("source-quality-verification");
@@ -34567,6 +35111,10 @@ var TypeScriptConfig = class extends import_projen24.Component {
   DEFAULT_STATE_FILE_PATH,
   DEFAULT_STATUS_LABELS,
   DEFAULT_TEARDOWN_BRANCH_PATTERNS,
+  DEFAULT_TEMPORAL_FRAMING_CADENCES,
+  DEFAULT_TEMPORAL_FRAMING_EMIT_CHECKER,
+  DEFAULT_TEMPORAL_FRAMING_ENABLED,
+  DEFAULT_TEMPORAL_FRAMING_PATHS,
   DEFAULT_TYPE_LABELS,
   DEFAULT_UNBLOCK_COMMENT_TEMPLATE,
   DEFAULT_UNBLOCK_DEPENDENTS_ENABLED,
@@ -34598,6 +35146,7 @@ var TypeScriptConfig = class extends import_projen24.Component {
   SUPPRESSED_WORKFLOW_RULE_NAMES,
   SampleLang,
   StarlightProject,
+  TEMPORAL_FRAMING_CATEGORY_VALUES,
   TIER_AWARE_BUNDLE_NAMES,
   TestRunner,
   TsDocCoverageKind,
@@ -34721,6 +35270,8 @@ var TypeScriptConfig = class extends import_projen24.Component {
   renderSkillEvalsRunnerScript,
   renderSourceTierExamples,
   renderStubIndexConventionRuleContent,
+  renderTemporalFramingCheckerScript,
+  renderTemporalFramingRuleContent,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,
@@ -34746,6 +35297,7 @@ var TypeScriptConfig = class extends import_projen24.Component {
   resolveSharedEditing,
   resolveSkillEvals,
   resolveTemplateVariables,
+  resolveTemporalFraming,
   resolveTypeScriptProjectOutdir,
   resolveUnblockDependents,
   runScan,
@@ -34767,6 +35319,7 @@ var TypeScriptConfig = class extends import_projen24.Component {
   validateSharedEditingConfig,
   validateSkillEvalsConfig,
   validateStarlightSingleton,
+  validateTemporalFramingConfig,
   validateUnblockDependentsConfig,
   vitestBundle
 });