chore: import upstream snapshot with attribution

test/skill-e2e-ship-section-loading.test.ts

@@ -0,0 +1,83 @@
+/**
+ * /ship section-loading E2E (periodic, paid, SDK capture) — v2 plan T9 mitigation
+ * layer 5: the behavioral guard that a real agent Reads the carved sections a
+ * version-changing ship requires instead of working from the skeleton's memory.
+ *
+ * Detection is LOSSLESS. Earlier this test drove a real PTY and scraped the ANSI
+ * screen buffer for `sections/<file>.md` paths, which silently saw nothing in a
+ * Conductor PTY (cursor-positioned tool renders + an unanswered question loop
+ * defeat the regex — it reported `read: []` even when the agent did the work). It
+ * now runs the skill through `claude -p` (the SDK path the AUQ matrix uses) and
+ * detects section reads from the tool-use stream (`Read` calls whose file_path
+ * contains `sections/review-army.md` / `sections/changelog.md`).
+ *
+ * Hermetic, not install-mutating: the freshly-generated worktree skeleton +
+ * sections are copied into a throwaway fixture dir and the absolute path is pinned,
+ * so the test validates the current carve without touching the user's active
+ * ~/.claude install. (Install-layout linking is covered by
+ * setup-sections-linking.test.ts.)
+ *
+ * The agent is told AskUserQuestion is unavailable and is given the version-changing
+ * situation explicitly (no Bash, so it can't and needn't probe git), so it follows
+ * the skeleton's STOP-Read directives for that situation. Cost: ~$1-2/run.
+ * Periodic tier.
+ */
+
+import { describe, test, expect } from 'bun:test';
+import {
+  setupSkillDir,
+  skillFromWorktree,
+  captureSectionReads,
+} from './helpers/auq-sdk-capture';
+
+const shouldRun = !!process.env.EVALS && process.env.EVALS_TIER === 'periodic';
+const describeE2E = shouldRun ? describe : describe.skip;
+const runId = `ship-section-loading-${process.env.EVALS_RUN_ID ?? 'local'}`;
+
+// Sections every version-changing ship must consult.
+const REQUIRED_SECTIONS = ['review-army.md', 'changelog.md'];
+
+const FIXTURES: Record<string, string> = {
+  VERSION: '0.0.1\n',
+  'package.json': JSON.stringify({ name: 'fx', version: '0.0.1', private: true }, null, 2) + '\n',
+  'CHANGELOG.md': '# Changelog\n\n## [0.0.1] - 2026-01-01\n\n- Initial release\n',
+  'app.js': '// base\nexport function newThing() { return 42; }\n',
+  'app.test.js': 'test("newThing", () => {});\n',
+};
+
+describeE2E('/ship section-loading E2E (periodic, SDK capture)', () => {
+  test(
+    'fresh version-changing ship Reads the required sections',
+    async () => {
+      const { skillMd, sectionsFrom } = skillFromWorktree('ship');
+      const planDir = setupSkillDir({
+        skillName: 'ship',
+        skillMd,
+        sectionsFrom,
+        fixtures: FIXTURES,
+        tmpPrefix: 'gstack-ship-secload-',
+      });
+
+      const { readSections, reportProduced, output } = await captureSectionReads({
+        planDir,
+        skillName: 'ship',
+        scenario:
+          'This is a FRESH version-changing ship: the branch has a real code change (app.js gained a new function with a test), VERSION still equals the base version (0.0.1, so it needs a bump), and CHANGELOG.md needs a new entry. Follow the skill\'s flow for a version-changing ship: run the pre-landing review and prepare the CHANGELOG entry. Produce the ship plan / review report. Do NOT actually commit, push, or open a PR.',
+        requiredSections: REQUIRED_SECTIONS,
+        reportMarker: /version|changelog|review|ship/i,
+        testName: 'ship-section-loading',
+        runId,
+      });
+
+      const missing = REQUIRED_SECTIONS.filter(s => !readSections.has(s));
+      expect({ reportProduced, read: [...readSections], missing }).toEqual({
+        reportProduced: true,
+        read: expect.any(Array),
+        missing: [],
+      });
+      // Guard against an empty pass: the report must have real content.
+      expect(output.trim().length).toBeGreaterThan(200);
+    },
+    360_000,
+  );
+});