@codedrifters/configulator 0.0.216 → 0.0.217

package/lib/index.mjs

@@ -4464,7 +4464,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. 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. One person per session, tracked by people:* GitHub issue labels.",
   model: AGENT_MODEL.POWERFUL,
   maxTurns: 80,
   platforms: { cursor: { exclude: true } },
@@ -4514,8 +4514,16 @@ var peopleProfileAnalystSubAgent = {
     "7. **Cross-reference, don't duplicate.** When the profile mentions a",
     "   company, software product, or meeting already tracked by the",
     "   consuming project, link to the existing artifact rather than",
-    "   duplicating its content. Do not create downstream research",
-    "   issues for these cross-references \u2014 only link.",
+    "   duplicating its content.",
+    "8. **Follow-up, don't widen scope.** If the session turns up adjacent",
+    "   research questions (a significant employer worth profiling, a",
+    "   software product the person created or leads), emit a follow-up",
+    "   issue rather than expanding the profile beyond its scope.",
+    "   Companies are handed off to the `company-profile` bundle via",
+    "   `company:research` issues; software products are handed off to",
+    "   the `software-profile` bundle via `software:research` issues.",
+    "   Meeting notes remain link-only \u2014 this agent never creates",
+    "   meeting-research issues.",
     "",
     "---",
     "",
@@ -4543,13 +4551,13 @@ var peopleProfileAnalystSubAgent = {
     "## State Machine Overview",
     "",
     "```",
-    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
-    "\u2502 1. RESEARCH       \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 2. DRAFT PROFILE     \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 3. FOLLOWUP       \u2502",
-    "\u2502 Collect public    \u2502     \u2502 Write the structured \u2502     \u2502 Cross-link the    \u2502",
-    "\u2502 sources into a    \u2502     \u2502 markdown profile to  \u2502     \u2502 profile to existing\u2502",
-    "\u2502 bounded notes     \u2502     \u2502 the configured path  \u2502     \u2502 companies, software\u2502",
-    "\u2502 file              \u2502     \u2502                      \u2502     \u2502 and meeting notes \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\u2518",
+    "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+    "\u2502 1. RESEARCH       \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 2. DRAFT PROFILE     \u2502\u2500\u2500\u2500\u2500\u25B6\u2502 3. FOLLOWUP        \u2502",
+    "\u2502 Collect public    \u2502     \u2502 Write the structured \u2502     \u2502 Cross-link existing\u2502",
+    "\u2502 sources into a    \u2502     \u2502 markdown profile to  \u2502     \u2502 artifacts; enqueue \u2502",
+    "\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",
     "```",
     "",
     "**Issue labels encode the phase:**",
@@ -4558,19 +4566,21 @@ 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. No new downstream issues. |",
+    "| `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. |",
     "",
     "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.",
+    "not surface any cross-references worth linking and no companies or",
+    "software products warrant downstream research.",
     "",
     "**Shortened paths:**",
     "- Research phase determines the person is out of scope (not",
     "  relevant, insufficient public material) \u2192 research issue closes",
     "  with a justification and no downstream issues are created \u2192 **1 session**.",
-    "- Short profile with no cross-references needed \u2192 **2 sessions**.",
+    "- Short profile with no cross-references and no downstream",
+    "  candidates \u2192 **2 sessions**.",
     "",
     "---",
     "",
@@ -4586,8 +4596,8 @@ var peopleProfileAnalystSubAgent = {
     "| `<PROFILES_DIR>` | Final person profile files | `<PEOPLE_ROOT>/profiles/` |",
     "| `<NOTES_DIR>` | Research-notes files from Phase 1 | `<PEOPLE_ROOT>/notes/` |",
     "| `<PERSON_SLUG>` | Short kebab-case slug identifying the person | derived from the person's name |",
-    "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references) | `docs/companies/profiles/` |",
-    "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references) | `docs/software/profiles/` |",
+    "| `<COMPANIES_DIR>` | Where existing company profiles live (for cross-references and duplicate detection during followup) | `docs/companies/profiles/` |",
+    "| `<SOFTWARE_DIR>` | Where existing software profiles live (for cross-references and duplicate detection during followup) | `docs/software/profiles/` |",
     "| `<MEETINGS_DIR>` | Where meeting notes live (for cross-references) | `docs/meetings/` |",
     "",
     "If `docs/project-context.md` specifies a different people-research",
@@ -4801,11 +4811,13 @@ var peopleProfileAnalystSubAgent = {
     "   ```",
     "",
     "4. **Decide whether a followup issue is warranted.** Create a",
-    "   `people:followup` issue (depending on this draft issue) only if",
-    "   the profile's Candidate Cross-References lists at least one",
-    "   company, software product, or meeting already tracked by the",
-    "   consuming project. Otherwise, note in the draft issue's closing",
-    "   comment that no followup is needed.",
+    "   `people:followup` issue (depending on this draft issue) if the",
+    "   profile's Candidate Cross-References lists at least one company,",
+    "   software product, or meeting \u2014 whether or not the entity is",
+    "   already profiled. The followup phase links what exists and",
+    "   enqueues downstream research for what doesn't. Only skip the",
+    "   followup when the profile surfaced no cross-reference candidates",
+    "   at all; note this in the draft issue's closing comment.",
     "",
     "5. **Commit and push** the profile file. Close the draft issue.",
     "",
@@ -4815,11 +4827,17 @@ var peopleProfileAnalystSubAgent = {
     "",
     "**Goal:** Populate the profile's `## Cross-References` section with",
     "links to existing artifacts \u2014 companies, software, meetings \u2014 that",
-    "the consuming project already tracks.",
-    "",
-    "**Budget:** No new web searches. No new downstream research issues.",
-    "Read the candidate cross-references, resolve them against the",
-    "configured directories, update the profile.",
+    "the consuming project already tracks, **and** enqueue downstream",
+    "`company:research` and `software:research` issues for unprofiled,",
+    "genuinely-relevant companies and software products surfaced in the",
+    "profile. Hand the candidates off to the `company-profile` and",
+    "`software-profile` bundles so they can be researched independently.",
+    "",
+    "**Budget:** No new web searches. Read the candidate cross-references,",
+    "resolve them against the configured directories, update the profile,",
+    "and enqueue downstream research issues where warranted. Markdown",
+    "cross-references in the profile are preserved \u2014 issue creation is",
+    "**additive** on top of the existing cross-reference behavior.",
     "",
     "### Steps",
     "",
@@ -4828,24 +4846,108 @@ var peopleProfileAnalystSubAgent = {
     "2. **Resolve company cross-references.** For each company named in",
     "   the profile's research notes or body text, look for a matching",
     "   file under `<COMPANIES_DIR>/`. If found, link it under",
-    "   `## Cross-References > Companies`. If not found, leave a TODO",
-    "   comment naming the company \u2014 the invoking project's team decides",
-    "   whether to kick off a separate company-profile pipeline.",
+    "   `## Cross-References > Companies` and do **not** open a",
+    "   `company:research` issue for it \u2014 the profile already exists.",
     "",
     "3. **Resolve software cross-references.** Same pattern against",
-    "   `<SOFTWARE_DIR>/`. Link what matches; leave TODOs for what",
-    "   doesn't.",
+    "   `<SOFTWARE_DIR>/`. If found, link under `## Cross-References >",
+    "   Software` and do **not** open a `software:research` issue.",
     "",
     "4. **Resolve meeting cross-references.** For meetings the person",
     "   participated in, look for a matching file under `<MEETINGS_DIR>/`",
-    "   by date or slug. Link matches; leave TODOs otherwise.",
+    "   by date or slug. Link matches; leave TODOs otherwise. Meeting",
+    "   notes are **always link-only** \u2014 this agent never opens",
+    "   meeting-research issues.",
+    "",
+    "5. **Enqueue a `company:research` issue per unprofiled, genuinely-",
+    "   relevant company.** For each company named in the profile that",
+    "   has no matching file under `<COMPANIES_DIR>/`, decide whether it",
+    "   warrants a downstream company profile (see restraint guidance",
+    "   below). If so, open an issue carrying:",
+    "",
+    "   - `type:company-profile`",
+    "   - `company:research`",
+    "   - `priority:medium`",
+    "   - `status:ready`",
     "",
-    "5. **Do not open downstream issues.** This pipeline emits no",
-    "   `company:research`, `research:scope`, or similar issues. Cross-",
-    "   references are link-only; downstream research is a separate",
-    "   human decision.",
+    "   The issue body must include:",
+    "   - A **discovery source** line naming this person profile",
+    "     (`Discovered while profiling: <person name>`)",
+    "   - A link to the person profile path (`Person profile: <PROFILES_DIR>/<PERSON_SLUG>.md`)",
+    "   - Enough identifying metadata \u2014 company name and primary domain/",
+    "     website \u2014 that the `company-profile-analyst` agent can begin",
+    "     research without revisiting this person profile",
+    "",
+    "6. **Enqueue a `software:research` issue per unprofiled software",
+    "   product the person has primary attribution for.** For each",
+    "   software product named in the profile with no matching file under",
+    "   `<SOFTWARE_DIR>/`, decide whether it warrants a downstream",
+    "   software profile (see restraint guidance below). If so, open an",
+    "   issue carrying:",
     "",
-    "6. **Commit and push** the updated profile. Close the followup issue.",
+    "   - `type:software-profile`",
+    "   - `software:research`",
+    "   - `priority:medium`",
+    "   - `status:ready`",
+    "",
+    "   The issue body must include:",
+    "   - A **discovery source** line naming this person profile",
+    "     (`Discovered while profiling: <person name>`)",
+    "   - A link to the person profile path (`Person profile: <PROFILES_DIR>/<PERSON_SLUG>.md`)",
+    "   - Enough identifying metadata \u2014 product name and vendor (the",
+    "     company that builds or maintains the product) \u2014 that the",
+    "     `software-profile-analyst` agent can begin research without",
+    "     revisiting this person profile",
+    "",
+    "7. **Avoid duplicates.** Before opening a `company:research` or",
+    "   `software:research` issue, verify no existing profile or open",
+    "   research issue already covers the candidate:",
+    "",
+    "   - Companies: check `<COMPANIES_DIR>/` for a matching profile",
+    "     file (by derived slug or by searching the directory for the",
+    "     company's name). If a profile exists, reuse it as a cross-",
+    "     reference only \u2014 **do not** open a new `company:research` issue.",
+    "   - Software: check `<SOFTWARE_DIR>/` the same way. If a profile",
+    "     exists, reuse it as a cross-reference only \u2014 **do not** open a",
+    "     new `software:research` issue.",
+    "   - Also scan open issues carrying the matching `company:research`",
+    "     or `software:research` label so this phase never re-opens",
+    "     research that is already queued.",
+    "",
+    "8. **Exercise restraint.** Only create downstream issues for",
+    "   entities **genuinely relevant** to the person's professional",
+    "   identity:",
+    "",
+    "   - **Companies:** open an issue for the person's current",
+    "     employer, significant past employers (roles of real tenure or",
+    "     leadership influence), companies where they sit on the board",
+    "     or act as an advisor, and companies they co-founded. Do **not**",
+    "     open an issue for every company on their LinkedIn, short",
+    "     consulting engagements, or employers tangential to the framing",
+    "     of this profile.",
+    "   - **Software:** open an issue only for products where the person",
+    "     has **primary attribution** \u2014 creator, maintainer, lead PM,",
+    "     founding engineer, or otherwise materially influenced the",
+    "     product. Do **not** open an issue for software the person",
+    "     merely uses, endorses in passing, or lists in a stack. When",
+    "     in doubt, leave the candidate as a markdown cross-reference",
+    "     and skip the downstream issue.",
+    "",
+    "9. **Assume the peers are present.** This pipeline assumes the",
+    "   `company-profile` and `software-profile` bundles are enabled in",
+    "   the consuming project. If a consuming project has disabled one",
+    "   of them, flag the followup issue with `status:needs-attention`",
+    "   and list the candidates that could not be routed \u2014 never invent",
+    "   an alternative label taxonomy.",
+    "",
+    "10. **Cross-link** \u2014 update the profile's `## Cross-References`",
+    "    section so each company or software entry references either",
+    "    the linked profile path (for existing profiles) or the newly-",
+    "    created downstream issue number (for candidates that were",
+    "    enqueued for research).",
+    "",
+    "11. **Commit and push** the updated profile. Close the followup",
+    "    issue.",
     "",
     "---",
     "",
@@ -4856,12 +4958,22 @@ var peopleProfileAnalystSubAgent = {
     "- `<NOTES_DIR>/` \u2014 research-notes files (Phase 1)",
     "- `<PROFILES_DIR>/` \u2014 person profiles (Phase 2, updated in Phase 3)",
     "",
-    "The pipeline produces **profiles and notes only**. It does not",
-    "create new companies, software evaluations, meeting notes, or any",
-    "other downstream artifacts \u2014 it only links to those that already",
-    "exist under the configured cross-reference directories. Keep this",
-    "boundary clean so the people-profile pipeline stays generic and",
-    "cheap to run.",
+    "In Phase 3, this agent also **creates `company:research` and",
+    "`software:research` issues** for companies and software products",
+    "surfaced in the profile that are not already tracked under",
+    "`<COMPANIES_DIR>/` or `<SOFTWARE_DIR>/`. It never writes the",
+    "downstream profiles themselves \u2014 those are the responsibility of the",
+    "`company-profile-analyst` and `software-profile-analyst` agents,",
+    "which pick up the issues this pipeline creates. Meeting notes",
+    "remain link-only across all phases.",
+    "",
+    "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",
+    "`software:research` issues \u2014 this agent never writes company",
+    "profiles, software profiles, product evaluations, or comparative",
+    "analyses itself. Keep this boundary clean so the people-profile",
+    "pipeline stays generic.",
     "",
     "---",
     "",
@@ -4877,15 +4989,35 @@ var peopleProfileAnalystSubAgent = {
     "  encountered in a public source.",
     "- **Cross-reference, don't duplicate.** Link to existing company,",
     "  software, and meeting artifacts rather than re-describing them.",
-    "- **No downstream issue creation.** Phase 3 emits no new research,",
-    "  profile, or requirement issues. Only link.",
+    "- **Delegate, don't duplicate.** Unprofiled companies and software",
+    "  products surfaced during profiling are handed off to the",
+    "  `company-profile` and `software-profile` bundles via",
+    "  `company:research` and `software:research` issues in Phase 3 \u2014",
+    "  never inlined as company or software profiles in this pipeline.",
+    "- **Check before enqueueing.** Before opening a `company:research`",
+    "  or `software:research` issue, verify no existing profile or open",
+    "  research issue already covers the candidate. Reuse existing",
+    "  profiles as cross-references rather than re-queuing research.",
+    "- **Restrain the queue.** Only enqueue downstream research for",
+    "  companies that are a current employer, significant past employer,",
+    "  board/advisor role, or co-founded venture \u2014 not every company on",
+    "  the person's r\xE9sum\xE9. Only enqueue software research for products",
+    "  the person has **primary attribution** for (creator, maintainer,",
+    "  lead PM), not products they merely use.",
+    "- **Meetings stay link-only.** Phase 3 never opens meeting-research",
+    "  or any other meeting-related issues. Meetings are cross-",
+    "  referenced only.",
+    "- **Produce profiles, not requirement or evaluation documents.** Do",
+    "  not open `type:requirement` or formal evaluation issues from this",
+    "  pipeline. Follow-up research is scoped through `company:research`",
+    "  and `software:research` only.",
     "- **Refresh, don't fork.** When a profile exists and is past its",
     "  cadence, update in place rather than creating a new slug."
   ].join("\n")
 };
 var profilePersonSkill = {
   name: "profile-person",
-  description: "Kick off a people-profile pipeline. Creates a people:research issue for the given person and dispatches Phase 1 (Research) in the people-profile-analyst agent.",
+  description: "Kick off a people-profile pipeline. Creates a people:research issue for the given person and dispatches Phase 1 (Research) in the people-profile-analyst agent. Phase 3 (Followup) enqueues downstream `company:research` and `software:research` issues for unprofiled, genuinely-relevant entities surfaced in the profile.",
   disableModelInvocation: true,
   userInvocable: true,
   context: "fork",
@@ -4947,13 +5079,19 @@ var profilePersonSkill = {
     "- A single person profile under the profiles directory",
     "- Cross-references to existing companies, software, and meetings",
     "  tracked elsewhere in the project",
-    "- This pipeline produces **profiles only** \u2014 it does not create",
-    "  companies, software, meetings, or any other downstream artifacts."
+    "- `company:research` issues for unprofiled companies surfaced in",
+    "  the profile (handed off to the `company-profile` bundle)",
+    "- `software:research` issues for software products the person has",
+    "  primary attribution for (handed off to the `software-profile`",
+    "  bundle)",
+    "- This pipeline produces **person profiles only** \u2014 it does not",
+    "  write company profiles, software profiles, meeting notes, or any",
+    "  other downstream artifacts itself."
   ].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 without creating new downstream issues.",
+  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.",
   appliesWhen: () => true,
   rules: [
     {
@@ -4969,10 +5107,12 @@ var peopleProfileBundle = {
         "GitHub issue labeled `people:research`, `people:draft`, or",
         "`people:followup`. All issues carry `type:people-profile`.",
         "",
-        "The pipeline produces **person profiles only**. Cross-references",
-        "to companies, software products, and meeting notes are link-only",
-        "\u2014 the followup phase never creates new downstream research,",
-        "profile, or requirement issues.",
+        "The pipeline produces **person profiles only**. Deeper research",
+        "on companies and software products surfaced while profiling is",
+        "delegated to the `company-profile` and `software-profile`",
+        "bundles via `company:research` and `software:research` issues",
+        "opened during Phase 3 (Followup). Meeting notes remain link-",
+        "only \u2014 the pipeline never creates meeting-research issues.",
         "",
         "See the `people-profile-analyst` agent definition for full",
         "workflow details, default paths, the person-role taxonomy, the",
@@ -5005,7 +5145,7 @@ var peopleProfileBundle = {
     {
       name: "people:followup",
       color: "D4C5F9",
-      description: "Phase 3: cross-link the profile to existing companies, software, and meeting notes"
+      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"
     }
   ]
 };