fix: harden foundation release gates (#56)

* fix: harden foundation release gates

* fix: align prompt activity example

Author: drewburchfield

src/__tests__/package-scripts.test.ts

@@ -51,6 +51,25 @@ describe('package scripts', () => {
     }
   });
 
+  it('lets Docker live testing use process environment credentials without a .env file', () => {
+    const result = spawnSync('node', [
+      '-e',
+      [
+        'process.env.HELPSCOUT_APP_ID="env-app";',
+        'process.env.HELPSCOUT_APP_SECRET="env-secret";',
+        'const { loadEnvFile } = require("./tests/test-docker.cjs");',
+        'const env = loadEnvFile();',
+        'process.stdout.write(`${env.HELPSCOUT_APP_ID}:${env.HELPSCOUT_APP_SECRET}`);',
+      ].join(''),
+    ], {
+      cwd: process.cwd(),
+      encoding: 'utf8',
+    });
+
+    expect(result.status).toBe(0);
+    expect(result.stdout).toBe('env-app:env-secret');
+  });
+
   it('guards sync:plugin when the target checkout has local files', () => {
     const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'helpscout-sync-plugin-'));
     const pluginDir = path.join(tempRoot, 'helpscout-navigator');

src/__tests__/prompts.test.ts

@@ -427,6 +427,25 @@ describe('PromptHandler', () => {
         expect(searchParams.extra).toBeUndefined();
       });
 
+      it('should keep the activity timestamp example internally consistent', async () => {
+        const request = {
+          method: 'prompts/get',
+          params: {
+            name: 'list-inbox-activity',
+            arguments: {
+              inboxId: 'inbox-123',
+              hours: 12,
+            }
+          }
+        };
+
+        const result = await promptHandler.getPrompt(request);
+        const promptText = result.messages[0].content.text;
+
+        expect(promptText).toContain('If current time is "2025-06-11T15:04:00Z" and hours is 12');
+        expect(promptText).toContain('then 12 hours ago would be "2025-06-11T03:04:00Z"');
+      });
+
       it('should include thread details when includeThreads is true', async () => {
         const request = {
           method: 'prompts/get',

src/prompts/index.ts

@@ -9,6 +9,13 @@ export class PromptHandler {
       .join('\n');
   }
 
+  private exampleHoursAgo(hours: number): string {
+    const exampleNow = new Date('2025-06-11T15:04:00Z');
+    return new Date(exampleNow.getTime() - hours * 60 * 60 * 1000)
+      .toISOString()
+      .replace(/\.\d{3}Z$/, 'Z');
+  }
+
   private parsePositiveHours(value: unknown): number | null {
     if (typeof value !== 'number' && typeof value !== 'string') {
       return null;
@@ -436,8 +443,8 @@ Note: The exact tag names may vary by organization. Common urgent tag variations
 
 2. Calculate the timestamp ${hours} hours ago from the current time.
    - Subtract ${hours} hours from the current timestamp
-   - Example: If current time is "2025-06-11T15:04:00Z" and hours is 24, 
-     then ${hours} hours ago would be "${new Date(new Date().getTime() - hours * 60 * 60 * 1000).toISOString().replace(/\.\d{3}Z$/, 'Z')}"
+   - Example: If current time is "2025-06-11T15:04:00Z" and hours is ${hours},
+     then ${hours} hours ago would be "${this.exampleHoursAgo(hours)}"
 
 3. Search for conversations in the specified inbox using the "searchConversations" tool:
    \`\`\`json

tests/test-docker.cjs

@@ -11,7 +11,7 @@ const MCP_RESPONSE_TIMEOUT_MS = 30_000;
 function loadEnvFile() {
   const envPath = path.join(__dirname, '..', '.env');
   if (!fs.existsSync(envPath)) {
-    throw new Error('Missing .env file. Copy .env.example to .env and add Help Scout OAuth credentials.');
+    return process.env;
   }
 
   const env = {};
@@ -288,3 +288,4 @@ if (require.main === module) {
 }
 
 module.exports = DockerLiveTester;
+module.exports.loadEnvFile = loadEnvFile;