@codedrifters/configulator 0.0.301 → 0.0.303

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`).",
       "",
       "---",
@@ -10991,14 +11496,17 @@ var maintenanceAuditBundle = buildMaintenanceAuditBundle();
 function buildMeetingAnalystSubAgent(tier) {
   return {
     name: "meeting-analyst",
-    description: "Processes meeting transcripts through a 4-phase pipeline: extract, notes, draft, and link",
+    description: "Processes meeting notes and transcripts (sibling-tree layout) through a 4-phase pipeline: extract, notes, draft, and link",
     model: tier,
     maxTurns: 80,
     platforms: { cursor: { exclude: true } },
     prompt: [
       "# Meeting Analyst Agent",
       "",
-      "You process meeting transcripts through a structured 4-phase pipeline.",
+      "You process meeting notes and transcripts through a structured",
+      "4-phase pipeline. Notes and transcripts live in **parallel sibling",
+      "trees** keyed by basename \u2014 see the **Meeting file layout** section",
+      "below for the canonical directory layout and input-case matrix.",
       "Each phase runs as a **separate agent session**, triggered by its own",
       "GitHub issue with a `meeting:*` phase label. You handle exactly **one",
       "phase per session** \u2014 read the issue to determine which phase to execute.",
@@ -11031,6 +11539,87 @@ function buildMeetingAnalystSubAgent(tier) {
       "   Apply the type-specific rules from the **Meeting type handling**",
       "   table (phases 1\u20132) and the area-filtered routing rules from the",
       "   **Areas filtering** table (phase 4).",
+      "7. **Treat notes and transcripts as paired siblings.** Notes are the",
+      "   curated narrative summary; transcripts are the verbatim evidence",
+      "   record. Both are first-class inputs to Phase 1 \u2014 never assume the",
+      "   transcript is the sole input.",
+      "",
+      "---",
+      "",
+      "## Meeting file layout (sibling-tree model)",
+      "",
+      "The bundle organises meeting artifacts as **three parallel trees**",
+      "rooted at `<meetingsRoot>`, partitioned by meeting type",
+      "(`internal` / `external`):",
+      "",
+      "```",
+      "<meetingsRoot>/",
+      "\u251C\u2500\u2500 transcripts/{internal,external}/   \u2190 raw verbatim transcripts (input, evidence)",
+      "\u251C\u2500\u2500 notes/{internal,external}/         \u2190 curated narrative summary (input + Phase 2 output)",
+      "\u2514\u2500\u2500 insights/{internal,external}/      \u2190 structured extraction (Phase 1 output)",
+      "```",
+      "",
+      "Within a given `{internal,external}` partition, the three trees share",
+      "**identical basenames**: a meeting captured as",
+      "`notes/internal/2026-03-14-sprint-kickoff.md` has its companion",
+      "transcript at `transcripts/internal/2026-03-14-sprint-kickoff.md` and",
+      "its Phase 1 extraction at `insights/internal/2026-03-14-sprint-kickoff.md`.",
+      "Agents look up siblings via filesystem (basename match across the",
+      "three trees), not via frontmatter cross-references.",
+      "",
+      "**Input-case matrix.** A meeting always has a `notes/` or",
+      "`transcripts/` entry (often both); Phase 1 must handle every case:",
+      "",
+      "| Notes file? | Transcript file? | Case | Phase-1 behaviour |",
+      "|-------------|------------------|------|--------------------|",
+      "| Yes | Yes | **Both** | Read both; transcript is verbatim ground truth, notes are first-draft summary. Set `transcript_available: true`, `confidence: high`. |",
+      "| Yes | No | **Notes-only** | Read notes only. Set `transcript_available: false`, `confidence: medium`. Do not invent dialogue the notes do not record. |",
+      "| No | Yes | **Transcript-only** | Read transcript only. Set `transcript_available: true`, `confidence: high`. Phase 2 will author the notes file from the transcript. |",
+      "",
+      "Notes frontmatter is **optional**. A bare imported file with no",
+      "frontmatter is a normal input case \u2014 treat missing fields as the",
+      "defaults `meeting_type: other`, `source: unknown`, `confidence: medium`,",
+      "and populate the real values on first processing. Never fail-loud on",
+      "absent frontmatter.",
+      "",
+      "### Notes / insights frontmatter schema",
+      "",
+      "The following frontmatter fields are recognised on notes and",
+      "insights files. Every field is optional \u2014 agents must read them",
+      "defensively and supply defaults when absent.",
+      "",
+      "| Field | Type | Purpose | Default |",
+      "|-------|------|---------|---------|",
+      "| `slug` | string | Starlight slug override; lets agents normalise the URL without renaming files. | derived from filename |",
+      "| `source` | `gemini` \\| `human` \\| `hybrid` \\| `unknown` | Provenance of the original notes (which authoring path produced them). | `unknown` |",
+      "| `transcript_available` | boolean | Cached result of the filesystem check for the sibling transcript. | re-derive from filesystem |",
+      "| `confidence` | `high` \\| `medium` \\| `low` | Reliability of the extraction. Downstream draft phases mark requirements **Tentative** when `confidence != high`. | `medium` |",
+      "",
+      "These additions coexist with the existing `meeting_type` and `areas`",
+      "fields documented in the **Meeting type handling** and **Areas",
+      "filtering** sections below.",
+      "",
+      "Transcript files themselves remain frontmatter-free \u2014 they are",
+      "evidence-only, and agents never navigate to a transcript as a",
+      "Starlight artifact.",
+      "",
+      "### Tree-level index pages",
+      "",
+      "Each of the three trees carries an `index.md` at its root and at",
+      "each `{internal,external}` partition so Starlight renders a clean",
+      "sidebar:",
+      "",
+      "- `<meetingsRoot>/transcripts/index.md` (and one per partition)",
+      "- `<meetingsRoot>/notes/index.md` (and one per partition)",
+      "- `<meetingsRoot>/insights/index.md` (and one per partition)",
+      "",
+      "Phase 1 must create the matching `insights/{type}/index.md` page",
+      "the first time it writes a file into that partition. Phase 2 must",
+      "create the matching `notes/{type}/index.md` page the first time it",
+      "writes a notes file into that partition. Follow the `section-index`",
+      "convention: a 1\u20132 paragraph summary of the tree's purpose plus a",
+      "linked listing of the partition's children. Append a row for the",
+      "current meeting's basename when an index already exists.",
       "",
       "---",
       "",
@@ -11159,17 +11748,25 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "## Phase 1: Extract (`meeting:extract`)",
       "",
-      "**Goal:** Read the meeting transcript and categorize all substantive content.",
+      "**Goal:** Read the available meeting inputs (notes, transcript, or both)",
+      "and categorize all substantive content into a structured extraction.",
       "",
       "### Steps",
       "",
-      "1. Read the transcript file specified in the issue body. Parse the",
-      "   meeting-note frontmatter first, capturing `meeting_type` and",
-      "   `areas`. Resolve `meeting_type` to a kind using the **Meeting type",
-      "   handling** table; note the resolved kind in the extraction",
-      "   frontmatter. If `meeting_type` is missing or not in the project's",
-      "   Recognized meeting types table, treat it as `other` and flag it",
-      "   in Open Questions.",
+      "1. Identify the meeting's basename and `{internal,external}` partition",
+      "   from the issue body, then read **both** sibling files when they",
+      "   exist:",
+      "   - Notes: `<meetingsRoot>/notes/{type}/<basename>.md`",
+      "   - Transcript: `<meetingsRoot>/transcripts/{type}/<basename>.md`",
+      "",
+      "   Use the **input-case matrix** in **Meeting file layout** to decide",
+      "   which case you are in (both / notes-only / transcript-only). Parse",
+      "   the notes frontmatter first (if a notes file exists), capturing",
+      "   `meeting_type`, `areas`, `source`, and `confidence`. Resolve",
+      "   `meeting_type` to a kind using the **Meeting type handling**",
+      "   table; note the resolved kind in the extraction frontmatter. If",
+      "   `meeting_type` is missing, treat it as `other` and flag it in",
+      "   Open Questions \u2014 do **not** fail-loud on missing frontmatter.",
       "2. Identify and categorize content into these buckets:",
       "",
       "   | Bucket | What to look for |",
@@ -11184,7 +11781,10 @@ function buildMeetingAnalystSubAgent(tier) {
       "   | **Strategic direction** | Business model changes, market positioning |",
       "   | **Product direction** | Roadmap changes, feature prioritization |",
       "",
-      "3. Write the extraction to a markdown file with structured sections:",
+      "3. Write the extraction to",
+      "   `<meetingsRoot>/insights/{type}/<basename>.md` (matching the",
+      "   basename and `{internal,external}` partition of the source",
+      "   notes / transcript) with structured sections:",
       "   - Attendees",
       "   - Decisions Made (with category and confidence: Firm / Tentative / Needs confirmation)",
       "   - Requirements Identified (with category and priority estimate)",
@@ -11195,9 +11795,14 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Companies of Interest (with type and context)",
       "   - Strategic / Product Direction",
       "",
-      "   Carry `meeting_type`, the resolved `meeting_kind`, and `areas`",
-      "   into the extraction frontmatter so downstream phases can gate",
-      "   behaviour without re-parsing the meeting note.",
+      "   Carry the following into the extraction frontmatter so downstream",
+      "   phases can gate behaviour without re-parsing the source files:",
+      "   `meeting_type`, the resolved `meeting_kind`, `areas`,",
+      "   `transcript_available: true|false` (cached from the filesystem",
+      "   check in step 1), and `confidence: high|medium|low` (per the",
+      "   input-case matrix \u2014 `high` when a transcript is present, `medium`",
+      "   on notes-only, never silently downgraded to `low` without an",
+      "   explicit reason recorded in Open Questions).",
       "",
       "4. **Apply type-specific rules.** Consult the **Meeting type handling**",
       "   table for the resolved kind and apply its phase-1 rules in",
@@ -11211,7 +11816,14 @@ function buildMeetingAnalystSubAgent(tier) {
       "     Interest (signal threshold still applies); capture customer",
       "     pain points as candidate BR (not FR).",
       "",
-      "5. **Create downstream phase issues** using `gh issue create`:",
+      "5. **Maintain the `insights/` tree index.** Ensure",
+      "   `<meetingsRoot>/insights/index.md` and",
+      "   `<meetingsRoot>/insights/{type}/index.md` exist (create them",
+      "   following the `section-index` convention if missing) and append",
+      "   a row for the current meeting's basename if one is not already",
+      "   present.",
+      "",
+      "6. **Create downstream phase issues** using `gh issue create`:",
       "   - Always create a `meeting:notes` issue (blocked on this extract issue)",
       "   - If requirements OR decisions/ADRs identified, create a `meeting:draft` issue",
       "     (blocked on the notes issue). For kind `standup`, skip the",
@@ -11220,18 +11832,59 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
       "     was created, otherwise blocked on the notes issue",
       "",
-      "6. Commit, push, and close the extract issue.",
+      "7. Commit, push, and close the extract issue.",
       "",
       "---",
       "",
       "## Phase 2: Notes (`meeting:notes`)",
       "",
-      "**Goal:** Transform the extraction into structured meeting notes.",
+      "**Goal:** Produce a curated `notes/{type}/<basename>.md` file that",
+      "reflects the structured meeting record. The pivot here from older",
+      'versions of this bundle: Phase 2 is no longer "author notes from',
+      'scratch." It is **enhance and verify** \u2014 restructure the existing',
+      "Gemini-generated notes (when present), verify factual claims",
+      "against the transcript (when present), and fall back to authoring",
+      "only when no notes file exists.",
       "",
       "### Steps",
       "",
-      "1. Read the extraction file referenced in the issue body (output of Phase 1).",
-      "2. Write structured meeting notes with these sections:",
+      "1. Read the extraction at",
+      "   `<meetingsRoot>/insights/{type}/<basename>.md` (output of Phase 1).",
+      "   Read the `transcript_available` and `confidence` fields from its",
+      "   frontmatter. Then determine which input-case branch applies by",
+      "   checking the filesystem for the sibling notes and transcript",
+      "   files.",
+      "2. **Branch by input case** (see the input-case matrix in the",
+      "   **Meeting file layout** section):",
+      "",
+      "   - **Both notes and transcript present** (enhance + verify):",
+      "     Read the existing `notes/{type}/<basename>.md` in place.",
+      "     Restructure it into the canonical section layout below.",
+      "     Verify every factual claim against the transcript \u2014 when the",
+      "     transcript contradicts the notes, the transcript wins and the",
+      "     notes are corrected. Fill in gaps the transcript reveals were",
+      "     missed. Overwrite the notes file in place; preserve the",
+      "     existing frontmatter and update only the fields you changed",
+      "     (e.g. flip `source: gemini` to `source: hybrid` once the agent",
+      "     has edited the file). Set `confidence: high`.",
+      "",
+      "   - **Notes only** (light structural cleanup):",
+      "     Read the existing `notes/{type}/<basename>.md`. Restructure it",
+      "     into the canonical section layout below. Do **not** invent",
+      "     dialogue or claims the notes do not record. Do **not** mark",
+      "     `confidence: high` \u2014 keep `confidence: medium` and record the",
+      '     reason ("no transcript available for verification") in the',
+      "     notes' Open Questions section so downstream phases know to",
+      "     treat downstream requirement drafts as `Tentative`.",
+      "",
+      "   - **Transcript only** (author from scratch):",
+      "     The notes file does not yet exist. Author",
+      "     `notes/{type}/<basename>.md` from the transcript using the",
+      "     section layout below. Populate frontmatter with",
+      "     `source: gemini` if the transcript is a Gemini transcript,",
+      "     otherwise `source: unknown`. Set `confidence: high`.",
+      "",
+      "3. Canonical notes section layout (applied in every branch above):",
       "   - Meeting metadata (title, date, attendees)",
       "   - Agenda / topics covered",
       "   - Key Discussion Points (organized by topic)",
@@ -11239,7 +11892,13 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Action Items (table: who, what, when)",
       "   - Open Questions",
       "   - Follow-up items",
-      "3. Commit, push, and close the notes issue.",
+      "4. **Maintain the `notes/` tree index.** Ensure",
+      "   `<meetingsRoot>/notes/index.md` and",
+      "   `<meetingsRoot>/notes/{type}/index.md` exist (create them",
+      "   following the `section-index` convention if missing) and append",
+      "   a row for the current meeting's basename if one is not already",
+      "   present.",
+      "5. Commit, push, and close the notes issue.",
       "",
       "---",
       "",
@@ -11252,7 +11911,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "### Steps",
       "",
-      "1. Read the extraction file from Phase 1.",
+      "1. Read the extraction file from Phase 1 at",
+      "   `<meetingsRoot>/insights/{type}/<basename>.md`.",
       "2. Check existing requirement registries and ADR registries for duplicates.",
       "3. Draft requirement proposals with:",
       "   - Category (FR, BR, NFR, etc.)",
@@ -11276,7 +11936,8 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "### Steps",
       "",
-      "1. Read the drafts from Phase 3 (if they exist) and the extraction from Phase 1.",
+      "1. Read the drafts from Phase 3 (if they exist) and the extraction",
+      "   from Phase 1 at `<meetingsRoot>/insights/{type}/<basename>.md`.",
       "   Re-read the extraction frontmatter for `meeting_kind` and `areas`,",
       "   then build the area-gate: the set of `docRoot` sub-folders that",
       "   are in scope for direct edits on this meeting. Apply the rules in",
@@ -11305,12 +11966,15 @@ function buildMeetingAnalystSubAgent(tier) {
       "   sprint-plan doc's area is in-scope, or always when no",
       "   `meetingAreas` are declared); for the kind `review`, mark",
       "   completed tasks in that same doc.",
-      "7. **Update the extraction file** with a `## Downstream Artifacts` section",
-      "   listing every issue and document created from this meeting. Note",
-      "   any items that were deferred to follow-up issues because of the",
-      "   area gate.",
-      "8. **Update the meeting notes** with a `## Related Issues` section listing",
-      "   all issues created from this meeting.",
+      "7. **Update the extraction file** at",
+      "   `<meetingsRoot>/insights/{type}/<basename>.md` with a",
+      "   `## Downstream Artifacts` section listing every issue and",
+      "   document created from this meeting. Note any items that were",
+      "   deferred to follow-up issues because of the area gate.",
+      "8. **Update the meeting notes** at",
+      "   `<meetingsRoot>/notes/{type}/<basename>.md` with a",
+      "   `## Related Issues` section listing all issues created from this",
+      "   meeting.",
       "9. Comment on the parent extract issue with a summary linking to all",
       "   created artifacts.",
       "10. Commit and push (if any file changes were made), then close the link issue.",
@@ -11344,21 +12008,27 @@ var processMeetingSkill = {
   agent: "meeting-analyst",
   platforms: { cursor: { exclude: true } },
   instructions: [
-    "# Process Meeting Transcript",
+    "# Process Meeting",
     "",
-    "Kick off meeting transcript processing by executing Phase 1 (Extract)",
-    "and creating downstream phase issues for the remaining phases.",
+    "Kick off meeting processing by executing Phase 1 (Extract) and",
+    "creating downstream phase issues for the remaining phases. Inputs",
+    "live in the **sibling-tree layout**: pass any file from",
+    "`<meetingsRoot>/notes/{type}/` or `<meetingsRoot>/transcripts/{type}/`",
+    "(both, notes-only, and transcript-only are all valid input cases).",
     "",
     "## Usage",
     "",
-    "/process-meeting <path-to-transcript>",
+    "/process-meeting <path-to-notes-or-transcript>",
     "",
     "## Steps",
     "",
-    "1. Read the provided transcript file",
-    "2. Execute Phase 1 (Extract) \u2014 categorize transcript content into",
+    "1. Identify the meeting's basename and `{internal,external}`",
+    "   partition from the provided path, then read **every** sibling",
+    "   that exists (notes file and/or transcript file)",
+    "2. Execute Phase 1 (Extract) \u2014 categorize the available content into",
     "   decisions, requirements, action items, open questions, and more",
-    "3. Write the extraction to a markdown file",
+    "3. Write the extraction to",
+    "   `<meetingsRoot>/insights/{type}/<basename>.md`",
     "4. Create downstream phase issues using `gh issue create`:",
     "   - `meeting:notes` issue (always)",
     "   - `meeting:draft` issue (if requirements or decisions were found)",
@@ -11368,12 +12038,15 @@ var processMeetingSkill = {
     "",
     "## Input",
     "",
-    "Provide a path to a meeting transcript file (text or markdown).",
-    "The transcript should contain speaker-attributed dialogue.",
+    "Provide a path to a file in either `notes/` or `transcripts/`. The",
+    "agent will look up the sibling automatically via basename match. A",
+    "missing sibling is a normal case (notes-only or transcript-only) \u2014",
+    "the agent handles all three input cases.",
     "",
     "## Output",
     "",
-    "- An extraction markdown file with categorized meeting content",
+    "- A structured extraction at",
+    "  `<meetingsRoot>/insights/{type}/<basename>.md`",
     "- Phase issues with `meeting:*` labels for downstream agent sessions",
     "  to pick up (notes, draft, link)"
   ].join("\n")
@@ -11391,11 +12064,30 @@ function buildMeetingAnalysisBundle(tier = AGENT_MODEL.BALANCED) {
         content: [
           "# Meeting Processing Workflow",
           "",
-          "Use `/process-meeting <path>` to process a meeting transcript through a",
+          "Use `/process-meeting <path>` to process a meeting through a",
           "4-phase pipeline (extract \u2192 notes \u2192 draft \u2192 link). Each phase runs as a",
           "separate agent session tracked by a GitHub issue with a `meeting:*` label.",
           "See the `meeting-analyst` agent definition for full workflow details.",
           "",
+          "Meeting artifacts live in **three parallel trees** rooted at the",
+          "project's meetings root:",
+          "",
+          "- `transcripts/{internal,external}/` \u2014 verbatim transcripts (evidence)",
+          "- `notes/{internal,external}/` \u2014 curated narrative summary",
+          "  (input + Phase 2 output)",
+          "- `insights/{internal,external}/` \u2014 structured extraction (Phase 1 output)",
+          "",
+          "The three trees share identical basenames so a meeting's siblings",
+          "are looked up by filename, not by frontmatter cross-references.",
+          "Phase 1 accepts every input case (notes + transcript, notes only,",
+          "or transcript only) and Phase 2 enhances the notes file in place",
+          "rather than authoring it from scratch.",
+          "",
+          "Notes and insights files may carry optional frontmatter fields",
+          "`slug`, `source`, `transcript_available`, and `confidence`",
+          "alongside the existing `meeting_type` and `areas` fields. Missing",
+          "frontmatter is treated as a normal input case \u2014 never fail-loud.",
+          "",
           "Meeting notes may declare a `meeting_type` (one of the project's",
           "recognized types) and an `areas: [...]` list. The `meeting_type`",
           "resolves to a generic kind \u2014 `planning` / `review` / `brainstorm` /",
@@ -15750,6 +16442,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 +30155,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 +30513,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 +35298,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 +35333,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 +35457,8 @@ var TypeScriptConfig = class extends import_projen24.Component {
   renderSkillEvalsRunnerScript,
   renderSourceTierExamples,
   renderStubIndexConventionRuleContent,
+  renderTemporalFramingCheckerScript,
+  renderTemporalFramingRuleContent,
   renderUnblockDependentsScript,
   renderUnblockDependentsSection,
   requirementsAnalystBundle,
@@ -34746,6 +35484,7 @@ var TypeScriptConfig = class extends import_projen24.Component {
   resolveSharedEditing,
   resolveSkillEvals,
   resolveTemplateVariables,
+  resolveTemporalFraming,
   resolveTypeScriptProjectOutdir,
   resolveUnblockDependents,
   runScan,
@@ -34767,6 +35506,7 @@ var TypeScriptConfig = class extends import_projen24.Component {
   validateSharedEditingConfig,
   validateSkillEvalsConfig,
   validateStarlightSingleton,
+  validateTemporalFramingConfig,
   validateUnblockDependentsConfig,
   vitestBundle
 });