@codedrifters/configulator 0.0.259 → 0.0.260

package/lib/index.d.mts

@@ -1848,9 +1848,9 @@ declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths
  * `company-profile` (via `company:research`) and `software-profile`
  * (via `software:research`).
  *
- * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
- * (`/profile-person`), and `type:people-profile` plus `people:*` phase
- * labels.
+ * Ships a sub-agent (`people-profile-analyst`), two user-invocable
+ * skills (`/profile-person`, `/refresh-person`), and `type:people-profile`
+ * plus `people:*` phase labels for the four phases.
  */
 declare const peopleProfileBundle: AgentRuleBundle;
 

package/lib/index.d.ts

@@ -1897,9 +1897,9 @@ declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths
  * `company-profile` (via `company:research`) and `software-profile`
  * (via `software:research`).
  *
- * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
- * (`/profile-person`), and `type:people-profile` plus `people:*` phase
- * labels.
+ * Ships a sub-agent (`people-profile-analyst`), two user-invocable
+ * skills (`/profile-person`, `/refresh-person`), and `type:people-profile`
+ * plus `people:*` phase labels for the four phases.
  */
 declare const peopleProfileBundle: AgentRuleBundle;
 

package/lib/index.js

@@ -6271,7 +6271,7 @@ var orchestratorBundle = {
 // src/agent/bundles/people-profile.ts
 var peopleProfileAnalystSubAgent = {
   name: "people-profile-analyst",
-  description: "Researches an individual person (colleague, customer contact, vendor contact, partner contact, industry expert, or connector) from public sources and produces a structured markdown profile cross-linked to companies, software, and meeting notes, then enqueues downstream `company:research` and `software:research` issues for unprofiled companies and software products surfaced during profiling. One person per session, tracked by people:* GitHub issue labels.",
+  description: "Researches an individual person (colleague, customer contact, vendor contact, partner contact, industry expert, or connector) from public sources and produces a structured markdown profile cross-linked to companies, software, and meeting notes, then enqueues downstream `company:research` and `software:research` issues for unprofiled companies and software products surfaced during profiling. Also handles maintenance refreshes on a configurable staleness cadence (`people:refresh`). One person per session, tracked by people:* GitHub issue labels.",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 80,
   platforms: { cursor: { exclude: true } },
@@ -6331,6 +6331,12 @@ var peopleProfileAnalystSubAgent = {
     "   the `software-profile` bundle via `software:research` issues.",
     "   Meeting notes remain link-only \u2014 this agent never creates",
     "   meeting-research issues.",
+    "9. **Refresh is targeted re-verification, not re-research.**",
+    "   `people:refresh` runs a small number of targeted searches focused",
+    "   on the narrow set of facts that drift (role, employer, primary",
+    "   public channel) and updates the profile in place. It never",
+    "   re-runs the full research-phase sweep and never forks the profile",
+    "   under a new slug.",
     "",
     "---",
     "",
@@ -6365,6 +6371,15 @@ var peopleProfileAnalystSubAgent = {
     "\u2502 bounded notes     \u2502     \u2502 the configured path  \u2502     \u2502 company/software   \u2502",
     "\u2502 file              \u2502     \u2502                      \u2502     \u2502 research issues    \u2502",
     "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+    "",
+    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "\u2502 4. REFRESH        \u2502  (cadence-driven, or on-demand)",
+    "\u2502 Re-verify an      \u2502",
+    "\u2502 existing profile  \u2502",
+    "\u2502 with targeted web \u2502",
+    "\u2502 searches. Update  \u2502",
+    "\u2502 in place.         \u2502",
+    "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
     "```",
     "",
     "**Issue labels encode the phase:**",
@@ -6374,13 +6389,13 @@ var peopleProfileAnalystSubAgent = {
     "| `people:research` | 1. Research | Gather public sources. Write a bounded research-notes file. Create the draft issue. |",
     "| `people:draft` | 2. Draft | Read the research notes. Write the structured profile to `<PROFILES_DIR>`. Create the followup issue if warranted. |",
     "| `people:followup` | 3. Followup | Read the profile. Update cross-references to existing companies, software, and meeting notes. Enqueue `company:research` and `software:research` issues for unprofiled, genuinely-relevant entities surfaced in the profile. |",
+    "| `people:refresh` | 4. Refresh | Read an existing profile. Run 3\u20135 targeted web searches for role, employer, and primary public channel changes. Update the profile in place and add a revision-history entry. |",
     "",
     "All issues also carry `type:people-profile` and a `status:*` label.",
     "",
     "**Issue count per person cycle:** 1 research + 1 draft + 0\u20131 followup =",
-    "**2\u20133 sessions**. The followup phase is skipped when the profile did",
-    "not surface any cross-references worth linking and no companies or",
-    "software products warrant downstream research.",
+    "**2\u20133 sessions** on the initial cycle. `people:refresh` is an",
+    "independent downstream cycle that runs on its own cadence.",
     "",
     "**Shortened paths:**",
     "- Research phase determines the person is out of scope (not",
@@ -6388,14 +6403,17 @@ var peopleProfileAnalystSubAgent = {
     "  with a justification and no downstream issues are created \u2192 **1 session**.",
     "- Short profile with no cross-references and no downstream",
     "  candidates \u2192 **2 sessions**.",
+    "- Refresh that finds no material change \u2192 **1 session** (revision-",
+    "  history entry only, profile body unchanged).",
     "",
     "---",
     "",
     "## Configurable Paths",
     "",
     "The pipeline uses these placeholders. Consuming projects override the",
-    "defaults by passing paths in the `/profile-person` skill invocation",
-    "or by extending this rule in their own `agentConfig.rules`.",
+    "defaults by passing paths in the `/profile-person` or `/refresh-person`",
+    "skill invocations, or by extending this rule in their own",
+    "`agentConfig.rules`.",
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
@@ -6417,26 +6435,37 @@ var peopleProfileAnalystSubAgent = {
     "## Refresh Cadence",
     "",
     "Profiles go stale. A person changes jobs, publishes new work, or",
-    "shifts focus. The pipeline supports a configurable refresh cadence:",
+    "shifts focus. The pipeline supports a configurable refresh cadence",
+    "so `people:refresh` issues can be filed on a schedule without",
+    "hardcoding the interval:",
     "",
-    "- **Default cadence:** 180 days from the profile's `date` frontmatter.",
-    "- **Override:** the invoking issue body may specify a `refresh_days: N`",
-    "  field, or the consuming project may set a project-wide default in",
-    "  `docs/src/content/docs/project-context.md`.",
+    "- **Default staleness threshold:** 180 days from the profile's",
+    "  `date` frontmatter.",
+    "- **Override precedence** (first match wins):",
+    "  1. `refresh_days` in the issue body (per-run override)",
+    "  2. `refresh_days` frontmatter on the profile itself",
+    "  3. Project-wide default declared under a `## Refresh Cadence`",
+    "     section in `docs/src/content/docs/project-context.md`",
+    "  4. Built-in default: **180 days**",
     "",
-    "When the `/profile-person` skill is invoked for a slug that already",
-    "has a profile:",
+    "When the `/refresh-person` skill is invoked for an existing profile:",
     "",
-    "- If the profile is **younger** than the refresh cadence, the skill",
-    "  exits with a message pointing to the existing profile. Pass",
+    "- If the profile is **younger** than the staleness threshold, the",
+    "  skill exits with a message pointing to the existing profile. Pass",
     "  `force: true` in the issue body to refresh anyway.",
-    "- If the profile is **older** than the refresh cadence, the pipeline",
-    "  proceeds in update-in-place mode: Phase 2 edits the existing file,",
-    "  preserves its slug, and bumps the `date` frontmatter.",
+    "- If the profile is **older** than the staleness threshold, the",
+    "  pipeline files a `people:refresh` issue and Phase 4 updates the",
+    "  existing file in place, preserving its slug and bumping the",
+    "  `date` frontmatter.",
+    "",
+    "The same precedence and `force: true` semantics apply when",
+    "`/profile-person` is invoked for a slug that already has a profile:",
+    "a fresh profile short-circuits; a stale profile is updated in place",
+    "by Phase 2 rather than forked under a new slug.",
     "",
     "Refresh mode never changes the profile's role without an explicit",
-    "override in the refresh request \u2014 role changes are material and",
-    "warrant a human review step.",
+    "override in the refresh request (`retype: <role>`) \u2014 role changes",
+    "are material and warrant a human review step.",
     "",
     "---",
     "",
@@ -6445,7 +6474,8 @@ var peopleProfileAnalystSubAgent = {
     "Run this loop exactly once per session. Never start a second issue.",
     "",
     "1. Claim one open `type:people-profile` issue using phase priority:",
-    "   `people:research` > `people:draft` > `people:followup`.",
+    "   `people:research` > `people:draft` > `people:followup` >",
+    "   `people:refresh`.",
     "2. Transition `status:ready` \u2192 `status:in-progress` and create the",
     "   branch per your project's branch-naming convention.",
     "3. Execute the phase handler that matches the issue's `people:*`",
@@ -6613,6 +6643,11 @@ var peopleProfileAnalystSubAgent = {
     "   <what the profile could not answer; flag anything the followup",
     "   phase should cross-reference>",
     "",
+    "   ## Revision History",
+    "   | Date | Changes |",
+    "   |------|---------|",
+    "   | YYYY-MM-DD | Initial profile |",
+    "",
     "   ## Sources",
     "   - <source URL> \u2014 <date accessed>",
     "   ```",
@@ -6758,12 +6793,87 @@ var peopleProfileAnalystSubAgent = {
     "",
     "---",
     "",
+    "## Phase 4: Refresh (`people:refresh`)",
+    "",
+    "**Goal:** Re-verify an existing profile against a narrow set of facts",
+    "that tend to drift \u2014 current role, current employer, primary public",
+    "channel (email, handle, personal site) \u2014 with a small number of",
+    "targeted web searches, then update the profile in place.",
+    "",
+    "**Budget:** 3\u20135 targeted web searches focused on the narrow delta",
+    "set. Do not redo the full research-phase sweep, do not re-gather the",
+    "full background, and do not rewrite the profile body for facts that",
+    "have not changed.",
+    "",
+    "### Steps",
+    "",
+    "1. **Read the existing profile** at the path referenced in the issue",
+    "   body. If the profile file is missing, close the issue with",
+    "   `status:needs-attention` and stop.",
+    "",
+    "2. **Confirm the staleness threshold.** Compare the profile's `date`",
+    "   frontmatter against today's date and the `refresh_days`",
+    "   frontmatter (or the project default from the Refresh Cadence",
+    "   section above). If the profile is younger than the threshold and",
+    "   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 3\u20135 targeted searches.** Focus on the narrow delta set:",
+    "   - Current role / title at the current employer",
+    "   - Current employer (has the person changed jobs?)",
+    "   - Primary public channel (personal site URL, primary social",
+    "     handle, speaker inquiry form, public email if listed)",
+    "   - Optional: one search for notable recent public work (a new",
+    "     talk, post, or project) if the profile's Expertise Signals",
+    "     section has no entry from the last 12 months",
+    "",
+    "4. **Update the profile in place.** Edit only the affected sections",
+    "   (typically `## Current Position`, `## Contact Preferences`, and",
+    "   occasionally `## Expertise Signals`). Cite every new claim.",
+    "   Preserve the slug and the original `parent_issue` field. Bump the",
+    "   `date` frontmatter to today's date. Leave untouched sections",
+    "   untouched \u2014 refresh is a narrow delta, not a rewrite.",
+    "",
+    "5. **Do not silently re-type the person.** If the refresh surfaces",
+    "   evidence that the person's primary role has changed (e.g., a",
+    "   customer-contact who now works at your own organization and",
+    "   should become a colleague), flag it in `## Risks / Open Questions`",
+    "   and stop \u2014 do **not** rewrite the `role` frontmatter without an",
+    "   explicit override in the refresh issue body (`retype: <role>`).",
+    "",
+    "6. **Append a revision-history row.** Summarize the delta in one",
+    "   line:",
+    "",
+    "   ```markdown",
+    "   | YYYY-MM-DD | Refreshed: <one-line summary of what changed> |",
+    "   ```",
+    "",
+    "   When the search budget finds no material change, the row still",
+    "   appears so the next scheduled refresh knows this profile was",
+    "   reviewed:",
+    "",
+    "   ```markdown",
+    "   | YYYY-MM-DD | Refreshed: no material change |",
+    "   ```",
+    "",
+    "7. **Respect privacy.** The narrow delta set is bounded to public",
+    "   professional facts. Never expand the refresh into private contact",
+    "   details, family information, or other non-professional data \u2014",
+    "   even if a search surfaces them. Privacy guardrails from Phase 1",
+    "   apply to every refresh.",
+    "",
+    "8. **Commit and push.** Close the refresh issue with a short comment",
+    "   summarizing the delta (or `no material change`).",
+    "",
+    "---",
+    "",
     "## Output Boundaries",
     "",
     "This agent writes **only** to:",
     "",
     "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
-    "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phase 3)",
+    "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phases",
+    "  3 and 4)",
     "",
     "In Phase 3, this agent also **creates `company:research` and",
     "`software:research` issues** for companies and software products",
@@ -6774,6 +6884,13 @@ var peopleProfileAnalystSubAgent = {
     "which pick up the issues this pipeline creates. Meeting notes",
     "remain link-only across all phases.",
     "",
+    "In Phase 4, this agent only updates an existing profile in place \u2014",
+    "it never forks a new profile under a different slug and never",
+    "enqueues downstream `company:research` or `software:research`",
+    "issues. Cross-references surfaced during a refresh are flagged in",
+    "`## Risks / Open Questions` for a follow-up `people:followup` pass",
+    "to handle.",
+    "",
     "The pipeline produces **person profiles and notes only**. Deeper",
     "research on companies and software products is delegated to",
     "downstream research pipelines via `company:research` and",
@@ -6818,6 +6935,15 @@ var peopleProfileAnalystSubAgent = {
     "  not open `type:requirement` or formal evaluation issues from this",
     "  pipeline. Follow-up research is scoped through `company:research`",
     "  and `software:research` only.",
+    "- **Refresh respects the cadence.** Phase 4 exits early when the",
+    "  profile is younger than the staleness threshold and `force: true`",
+    "  is not set. It always appends a revision-history row so the next",
+    "  scheduled run knows the profile was reviewed.",
+    "- **Refresh is narrow, not a rewrite.** Phase 4 re-verifies role,",
+    "  employer, and primary public channel with 3\u20135 targeted searches",
+    "  and updates only the affected sections. It never re-runs the full",
+    "  research-phase sweep and never rewrites sections whose underlying",
+    "  facts have not changed.",
     "- **Refresh, don't fork.** When a profile exists and is past its",
     "  cadence, update in place rather than creating a new slug."
   ].join("\n")
@@ -6896,23 +7022,110 @@ var profilePersonSkill = {
     "  other downstream artifacts itself."
   ].join("\n")
 };
+var refreshPersonSkill = {
+  name: "refresh-person",
+  description: "Kick off a people-profile refresh cycle. Creates a people:refresh issue for an existing profile and dispatches Phase 4 (Refresh) in the people-profile-analyst agent. Refresh re-verifies the profile's narrow delta set (role, employer, primary public channel) with 3\u20135 targeted web searches and updates it in place. Respects a configurable staleness threshold so profiles younger than the threshold exit early.",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "people-profile-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Refresh Person",
+    "",
+    "Re-verify an existing person profile with a small number of",
+    "targeted web searches and update the profile in place. Creates a",
+    "`people:refresh` issue for the target profile and dispatches",
+    "Phase 4 (Refresh) in the people-profile-analyst agent.",
+    "",
+    "Refresh respects a configurable **staleness threshold** so scheduled",
+    "refreshes do not burn search budget on profiles that are still",
+    "fresh.",
+    "",
+    "## Usage",
+    "",
+    "/refresh-person <path-to-profile>",
+    "",
+    "Optional extensions in the issue body:",
+    "- `refresh_days: <N>` \u2014 override the default 180-day staleness",
+    "  threshold for this run",
+    "- `force: true` \u2014 refresh even if the profile is younger than the",
+    "  threshold",
+    "- `retype: <colleague | customer-contact | vendor-contact |",
+    "   partner-contact | industry-expert | connector>` \u2014 explicitly",
+    "   allow Phase 4 to change the profile's `role` when the refresh",
+    "   finds material evidence of a role-type change",
+    "",
+    "## Staleness Threshold",
+    "",
+    "Order of precedence (first match wins):",
+    "",
+    "1. `refresh_days` in the issue body (per-run override)",
+    "2. `refresh_days` frontmatter on the profile itself",
+    "3. Project-wide default declared under a `## Refresh Cadence`",
+    "   section in `docs/src/content/docs/project-context.md`",
+    "4. Built-in default: **180 days**",
+    "",
+    "If the profile's `date` frontmatter plus the resolved threshold is",
+    "in the future (i.e. the profile is still fresh) and `force: true`",
+    "is not set, Phase 4 closes the refresh issue with a short comment",
+    "and stops without running any searches.",
+    "",
+    "## Budget",
+    "",
+    "- **3\u20135 targeted web searches** focused on the narrow delta set:",
+    "  current role / title, current employer, primary public channel",
+    "  (personal site, handle, speaker inquiry form, public email).",
+    "- Optional: one search for notable recent public work if the",
+    "  profile has no Expertise Signals entry from the last 12 months.",
+    "",
+    "## Privacy",
+    "",
+    "Privacy guardrails from Phase 1 apply to every refresh. Never",
+    "record private contact details, family information, or other",
+    "non-professional personal data \u2014 even if a search surfaces them.",
+    "",
+    "## Steps",
+    "",
+    "1. Create a `people:refresh` issue with `type:people-profile`,",
+    "   `priority:medium`, and `status:ready`. Body must include the",
+    "   profile path and any overrides.",
+    "2. Execute Phase 4 (Refresh) of the people-profile-analyst agent.",
+    "",
+    "## Output",
+    "",
+    "- The profile is updated in place (affected sections edited,",
+    "  `date` bumped, slug preserved)",
+    "- A revision-history row summarizing the delta \u2014 or",
+    "  `Refreshed: no material change` when the search budget found",
+    "  nothing material"
+  ].join("\n")
+};
 var peopleProfileBundle = {
   name: "people-profile",
-  description: "People research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases. Cross-references existing companies, software, and meeting notes, and Phase 3 (Followup) hands unprofiled, genuinely-relevant companies and software products off to the `company-profile` and `software-profile` bundles via `company:research` and `software:research` issues.",
+  description: "People research and profiling pipeline: research, draft profile, followup, refresh. Enabled by default; domain-neutral; filesystem-durable between phases. Cross-references existing companies, software, and meeting notes, and Phase 3 (Followup) hands unprofiled, genuinely-relevant companies and software products off to the `company-profile` and `software-profile` bundles via `company:research` and `software:research` issues. Phase 4 (Refresh) re-verifies profiles on a configurable staleness cadence.",
   appliesWhen: () => true,
   rules: [
     {
       name: "people-profile-workflow",
-      description: "Describes the 3-phase people-profile pipeline, the people:* label taxonomy, the cross-reference model, and the boundary against downstream research agents.",
+      description: "Describes the 4-phase people-profile pipeline, the people:* label taxonomy, the cross-reference model, the refresh cadence rules, and the boundary against downstream research agents.",
       scope: AGENT_RULE_SCOPE.ALWAYS,
       content: [
         "# People Profile Workflow",
         "",
         "Use `/profile-person <person-name>` to kick off a person",
-        "research and profiling pipeline. The pipeline runs in up to 3",
-        "phases \u2014 research, draft, followup \u2014 each tracked by its own",
-        "GitHub issue labeled `people:research`, `people:draft`, or",
-        "`people:followup`. All issues carry `type:people-profile`.",
+        "research and profiling pipeline. The pipeline runs in up to 4",
+        "phases \u2014 research, draft, followup, refresh \u2014 each tracked by",
+        "its own GitHub issue labeled `people:research`, `people:draft`,",
+        "`people:followup`, or `people:refresh`. All issues carry",
+        "`type:people-profile`.",
+        "",
+        "One additional user-invocable skill drives the maintenance",
+        "phase independently:",
+        "",
+        "- `/refresh-person <path-to-profile>` \u2014 re-verify an existing",
+        "  profile with 3\u20135 targeted web searches and update it in",
+        "  place (Phase 4, respects a configurable staleness threshold).",
         "",
         "The pipeline produces **person profiles only**. Deeper research",
         "on companies and software products surfaced while profiling is",
@@ -6931,7 +7144,7 @@ var peopleProfileBundle = {
       tags: ["workflow"]
     }
   ],
-  skills: [profilePersonSkill],
+  skills: [profilePersonSkill, refreshPersonSkill],
   subAgents: [peopleProfileAnalystSubAgent],
   labels: [
     {
@@ -6953,6 +7166,11 @@ var peopleProfileBundle = {
       name: "people:followup",
       color: "D4C5F9",
       description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes, and enqueue follow-up research issues for unprofiled companies and software products"
+    },
+    {
+      name: "people:refresh",
+      color: "F9D0C4",
+      description: "Phase 4: re-verify an existing person profile with targeted web searches and update it in place"
     }
   ]
 };