Rebase fork onto upstream 0.9.1 with durable task coordination

.github/DISCUSSION_TEMPLATE/bug-reports.yml

@@ -51,16 +51,60 @@ body:
     id: version
     attributes:
       label: Prime Agent version
-      description: Include the output of `prime-agent --version`, or the commit if running from source.
-      placeholder: "0.0.0 or commit SHA"
+      description: Include the output of `prime-agent --version`, or the commit SHA when running from source.
+      placeholder: "e.g. 0.9.1 or 81ae3cb"
+    validations:
+      required: true
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: Installation method
+      description: How was this Prime Agent version installed?
+      options:
+        - Stable release installer
+        - Beta release installer
+        - npm package
+        - From source
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - macOS
+        - Linux
+        - Windows
+        - Windows Subsystem for Linux (WSL)
+        - Other
+    validations:
+      required: true
+  - type: input
+    id: os_version
+    attributes:
+      label: Operating system version
+      description: Include the exact release or build. For WSL, include both the distribution and Windows version.
+      placeholder: "e.g. macOS 15.6, Ubuntu 24.04, or Windows 11 24H2"
+    validations:
+      required: true
+  - type: dropdown
+    id: architecture
+    attributes:
+      label: CPU architecture
+      description: Use `uname -m`, or `$env:PROCESSOR_ARCHITECTURE` in PowerShell, if unsure.
+      options:
+        - arm64 / aarch64
+        - x86_64 / amd64
+        - Other
     validations:
       required: true
   - type: input
-    id: environment
+    id: shell_terminal
     attributes:
-      label: Environment
-      description: Include your operating system, terminal, and any other relevant environment details.
-      placeholder: "macOS 15, Terminal.app"
+      label: Shell and terminal
+      description: Include both the shell and terminal application where the problem occurred.
+      placeholder: "e.g. zsh 5.9 in Terminal.app or PowerShell 7.5 in Windows Terminal"
     validations:
       required: true
   - type: textarea

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -43,8 +43,21 @@ body:
     id: version
     attributes:
       label: Prime Agent version
-      description: Output of `prime-agent --version`.
-      placeholder: "e.g. 0.1.0"
+      description: Output of `prime-agent --version`, or the commit SHA when running from source.
+      placeholder: "e.g. 0.9.1 or 81ae3cb"
+    validations:
+      required: true
+  - type: dropdown
+    id: install_method
+    attributes:
+      label: Installation method
+      description: How was this Prime Agent version installed?
+      options:
+        - Stable release installer
+        - Beta release installer
+        - npm package
+        - From source
+        - Other
     validations:
       required: true
   - type: dropdown
@@ -55,9 +68,37 @@ body:
         - macOS
         - Linux
         - Windows
+        - Windows Subsystem for Linux (WSL)
+        - Other
+    validations:
+      required: true
+  - type: input
+    id: os_version
+    attributes:
+      label: Operating system version
+      description: Include the exact release or build. For WSL, include both the distribution and Windows version.
+      placeholder: "e.g. macOS 15.6, Ubuntu 24.04, or Windows 11 24H2"
+    validations:
+      required: true
+  - type: dropdown
+    id: architecture
+    attributes:
+      label: CPU architecture
+      description: Use `uname -m`, or `$env:PROCESSOR_ARCHITECTURE` in PowerShell, if unsure.
+      options:
+        - arm64 / aarch64
+        - x86_64 / amd64
         - Other
     validations:
       required: true
+  - type: input
+    id: shell_terminal
+    attributes:
+      label: Shell and terminal
+      description: Include both the shell and terminal application where the problem occurred.
+      placeholder: "e.g. zsh 5.9 in Terminal.app or PowerShell 7.5 in Windows Terminal"
+    validations:
+      required: true
   - type: textarea
     id: context
     attributes:

.github/PULL_REQUEST_TEMPLATE.md

@@ -6,7 +6,9 @@ https://github.com/PrimeIntellect-ai/prime-agent/discussions
 
 ## Context
 
-<!-- Link the accepted Issue or Discussion and explain why this change is needed. -->
+<!-- Link the accepted Issue or Discussion and explain why this change is needed.
+Prime Agent Linear tickets should normally use the Research team and the Prime Agent: Long-Horizon research project.
+If this change has no ticket, add `No-Ticket: <short reason>` below. -->
 
 ## Changes
 

.github/VOUCHED.td

@@ -1,2 +1,3 @@
 # Trusted external contributors, one GitHub username per line without @.
 # Maintainers, bots, and collaborators with write access are allowed automatically.
+sirouk

.github/workflows/build-binaries.yml

@@ -172,6 +172,41 @@ jobs:
             --base-url "$PRIME_AGENT_DOWNLOAD_BASE_URL" \
             --out-dir packages/coding-agent/release/beta
 
+      - name: Smoke test installer with npm 12
+        run: |
+          npm install --global npm@12.0.2
+          npm --version | grep -Eq '^12\.'
+
+          SMOKE_VERSION=0.0.0-installer-smoke
+          SMOKE_BASE_URL=http://127.0.0.1:18188
+          SMOKE_OUT=packages/coding-agent/release/npm12-smoke
+          SMOKE_ROOT=$(mktemp -d)
+
+          npm run release:pack -- \
+            --channel stable \
+            --version "$SMOKE_VERSION" \
+            --base-url "$SMOKE_BASE_URL" \
+            --out-dir "$SMOKE_OUT"
+
+          mkdir -p "$SMOKE_ROOT/releases/v$SMOKE_VERSION"
+          cp "$SMOKE_OUT/artifacts/"* "$SMOKE_ROOT/releases/v$SMOKE_VERSION/"
+          sed \
+            -e "s|__PRIME_AGENT_DOWNLOAD_BASE_URL__|$SMOKE_BASE_URL|g" \
+            -e 's|__PRIME_AGENT_DEFAULT_RELEASE_CHANNEL__|stable|g' \
+            install.sh > /tmp/prime-agent-npm12-install.sh
+
+          python3 -m http.server 18188 --bind 127.0.0.1 --directory "$SMOKE_ROOT" >/tmp/prime-agent-npm12-http.log 2>&1 &
+          server_pid=$!
+          trap 'kill "$server_pid" 2>/dev/null || true; rm -rf "$SMOKE_ROOT" "$SMOKE_OUT"' EXIT
+
+          curl -fsS --retry 5 --retry-connrefused "$SMOKE_BASE_URL/releases/v$SMOKE_VERSION/SHA256SUMS"
+          export NPM_CONFIG_PREFIX="$SMOKE_ROOT/npm-prefix"
+          PATH="$NPM_CONFIG_PREFIX/bin:$PATH" \
+            PRIME_AGENT_BOOTSTRAP_KERNEL_ON_INSTALL=0 \
+            PRIME_AGENT_INSTALLER_PLAIN=1 \
+            sh /tmp/prime-agent-npm12-install.sh "$SMOKE_VERSION"
+          test -x "$NPM_CONFIG_PREFIX/bin/prime-agent"
+
       - name: Upload production artifacts
         if: env.PUBLISH_PRODUCTION == 'true'
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7

.github/workflows/changelog-fragment.yml

@@ -0,0 +1,76 @@
+name: Changelog fragment
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+    branches: [main]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  changelog-fragment:
+    name: Check changelog fragment
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.type != 'Bot'
+    steps:
+      - name: Require a changelog fragment for changed packages or an explicit opt-out
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            if (pr.labels.some((label) => label.name === "no-changelog")) {
+              core.info("Label no-changelog is set; skipping changelog check.");
+              return;
+            }
+            // listFiles caps at 3000 files; beyond that the check cannot see every change.
+            if (pr.changed_files > 3000) {
+              core.setFailed("PR changes more than 3000 files; split it or apply the no-changelog label.");
+              return;
+            }
+            const files = await github.paginate(github.rest.pulls.listFiles, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: pr.number,
+              per_page: 100,
+            });
+            const packages = ["agent", "ai", "coding-agent", "tui"];
+            const failing = [];
+            for (const pkg of packages) {
+              const srcPrefix = `packages/${pkg}/src/`;
+              const srcChanged = files.some(
+                (f) =>
+                  f.filename.startsWith(srcPrefix) ||
+                  (f.previous_filename !== undefined && f.previous_filename.startsWith(srcPrefix)),
+              );
+              if (!srcChanged) {
+                continue;
+              }
+              // Fragments must be direct children of .changes/ — release.mjs ignores nested paths.
+              const fragmentRe = new RegExp(`^packages/${pkg}/\\.changes/[^/]+\\.md$`);
+              const hasFragment = files.some(
+                (f) =>
+                  f.status === "added" &&
+                  f.additions > 0 &&
+                  fragmentRe.test(f.filename) &&
+                  !f.filename.endsWith("/README.md"),
+              );
+              if (!hasFragment) {
+                failing.push(pkg);
+              }
+            }
+            if (failing.length === 0) {
+              core.info("Changelog fragments present for all changed packages.");
+              return;
+            }
+            core.setFailed(
+              failing
+                .map(
+                  (pkg) =>
+                    `packages/${pkg}/src changed but no changelog entry found. ` +
+                    `Add packages/${pkg}/.changes/<branch-slug>.md containing e.g. ` +
+                    "`- Fixed the frobnicator dropping input on resize.`, " +
+                    "or apply the no-changelog label.",
+                )
+                .join("\n"),
+            );

.github/workflows/ci.yml

@@ -109,6 +109,10 @@ jobs:
             package: packages/coding-agent
             command: npm run test:kernel
             install_uv: true
+          - name: runtime python
+            package: prime-agent-runtime
+            command: uv run python -m unittest discover -s test
+            install_uv: true
     steps:
       - name: Checkout
         uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0

.github/workflows/linear-ticket.yml

@@ -0,0 +1,42 @@
+name: Linear ticket
+
+on:
+  pull_request:
+    types: [opened, edited, reopened, synchronize]
+    branches: [main]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  linear-ticket:
+    name: Check Linear ticket link
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.user.type != 'Bot'
+    steps:
+      - name: Require a Linear ticket reference or an explicit opt-out
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const text = `${pr.title}\n${pr.body ?? ""}\n${pr.head.ref}`;
+            const ticket = /\bres-\d+\b|linear\.app\/[\w-]+\/issue\/res-\d+/i;
+            const optOut = /^\s*No-Ticket:\s*\S.*$/im;
+            if (ticket.test(text)) {
+              core.info("Linear ticket reference found.");
+              return;
+            }
+            const match = (pr.body ?? "").match(optOut);
+            if (match) {
+              core.info(`No-ticket opt-out present: ${match[0].trim()}`);
+              return;
+            }
+            core.setFailed(
+              [
+                "No Linear ticket is linked in this pull request.",
+                "Prime Agent tickets should normally use the Research team and the Prime Agent: Long-Horizon research project.",
+                "Add the ticket ID (e.g. RES-1234) or a linear.app issue link to the PR title or description,",
+                "or use a branch named after the ticket (e.g. res-1234).",
+                'If this change genuinely has no ticket, add a line to the PR description: "No-Ticket: <short reason>".',
+              ].join(" "),
+            );

AGENTS.md

@@ -104,28 +104,23 @@ You, yourself, are often running into a tmux session, so be careful when killing
 
 ## Changelog
 
-Location: `packages/*/CHANGELOG.md` (each package has its own)
+Location: `packages/<pkg>/.changes/<slug>.md` (one fragment file per PR per touched package)
 
 ### Format
 
-A flat list of plain bullets under `## [Unreleased]`. No `### Added` / `### Changed` / `### Fixed` / `### Removed` subsections — just one bullet per change, written as a short sentence starting with a past-tense verb (Added, Changed, Fixed, Removed). Keep each bullet to one line; describe the user-visible change, not the implementation.
+Do NOT edit `packages/*/CHANGELOG.md` directly. Instead, add a fragment file `packages/<pkg>/.changes/<slug>.md` (slug = kebab-case, branch- or ticket-derived, e.g. `eng-1234-fix-resize.md`) containing exactly the bullet line(s) for the change. Bullets are plain `- ...` lines with no `### Added` / `### Changed` / `### Fixed` / `### Removed` subsections — one bullet per change, written as a short sentence starting with a past-tense verb (Added, Changed, Fixed, Removed). Keep each bullet to one line; describe the user-visible change, not the implementation. The release script folds fragments into the release section of CHANGELOG.md and deletes them.
 
-Example of a well-formed `[Unreleased]` section:
+Example fragment (`packages/coding-agent/.changes/eng-1234-effort-command.md`):
 
 ```markdown
-## [Unreleased]
-
 - Added `/effort` to set the reasoning level, with autocomplete for the levels the current model supports.
-- Changed `prime-agent` to open a new chat by default instead of resuming the previous session.
-- Fixed onboarding showing no models after entering a provider key.
-- Removed the interactive `!` / `!!` bash shortcuts; use IPython instead.
 ```
 
 ### Rules
 
-- Read the full `[Unreleased]` section first so you don't duplicate an existing bullet
-- New entries ALWAYS go under `## [Unreleased]`
-- NEVER modify already-released version sections (e.g., `## [0.2.1]`) — each is immutable once released
+- One fragment file per PR per touched package; a fragment may contain multiple bullets
+- NEVER modify already-released version sections in CHANGELOG.md (e.g., `## [0.2.1]`) — each is immutable once released
+- Purely internal changes may opt out via the `no-changelog` PR label
 
 ### Attribution
 
@@ -183,7 +178,7 @@ Create provider file exporting:
 ### 7. Documentation
 
 - `packages/ai/README.md`: Add to providers table, document options/auth, add env vars
-- `packages/ai/CHANGELOG.md`: Add entry under `## [Unreleased]`
+- `packages/ai/.changes/<slug>.md`: Add a changelog fragment (see Changelog above)
 
 ## Releasing
 
@@ -196,15 +191,15 @@ Create provider file exporting:
 
 ### Steps
 
-1. **Update CHANGELOGs**: Ensure all changes since last release are documented in the `[Unreleased]` section of each affected package's CHANGELOG.md
+1. **Check fragments**: Ensure all changes since last release have fragment files in `packages/<pkg>/.changes/`
 
 2. **Run release script**:
    ```bash
    npm run release:patch    # Fixes and additions
    npm run release:minor    # API breaking changes
    ```
 
-The script handles: version bump, CHANGELOG finalization, commit, tag, publish, and adding new `[Unreleased]` sections.
+The script handles: version bump, folding `.changes/` fragments into the release section, commit, tag, and publish.
 
 ## **CRITICAL** Git Rules for Parallel Agents **CRITICAL**
 
@@ -239,7 +234,7 @@ git status
 
 # 2. Add ONLY your specific files
 git add packages/ai/src/providers/transform-messages.ts
-git add packages/ai/CHANGELOG.md
+git add packages/ai/.changes/eng-1234-fix-resize.md
 
 # 3. Commit
 git commit -m "fix(ai): description"