@tenderlead/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Studea Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# TenderLead CLI
+
+Read your TenderLead daily briefing from a terminal or another tool you control.
+
+## Install
+
+```bash
+npm install --global @tenderlead/cli
+```
+
+## Connect your account
+
+Open the account page from the CLI:
+
+```bash
+tenderlead login
+```
+
+Sign in with Google or an emailed sign-in link, then create a token under
+**API access**. Store it in the `TENDERLEAD_API_TOKEN` environment variable and
+run the brief command:
+
+```bash
+export TENDERLEAD_API_TOKEN="paste-token-here"
+tenderlead brief
+```
+
+Use JSON output for scripts and agents:
+
+```bash
+tenderlead brief --json
+```
+
+Tokens are customer-scoped, read-only, revocable, expire after 90 days, and are
+subject to the account's current TenderLead plan. Do not commit a token to a
+repository or paste it into a shared prompt. Revoke exposed tokens in Settings.
+
+Provider acceptance and API responses do not prove email inbox delivery.
+
+## Requirements
+
+- Node.js 18 or newer
+- An active TenderLead account
+
+## Licence
+
+MIT

package/bin/tenderlead.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const DEFAULT_BASE_URL = 'https://tenderlead.co.uk';
+const LOGIN_PATH = '/app/settings#api-access';
+
+function usage() {
+  return [
+    'Usage:',
+    '  tenderlead login',
+    '  tenderlead brief [--json]',
+    '',
+    'Login opens TenderLead Settings so you can create a customer-scoped token.',
+    'Set TENDERLEAD_API_TOKEN to that token before running brief.',
+  ].join('\n');
+}
+
+function parseArgs(argv) {
+  const command = argv[2];
+  if (command === 'login') return { command: 'login' };
+  if (command !== 'brief') throw new Error('Use the login or brief command.');
+  const options = { command: 'brief', json: false };
+  for (let index = 3; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--json') options.json = true;
+    else if (arg === '--help' || arg === '-h') options.help = true;
+    else throw new Error(`Unknown argument: ${arg}`);
+  }
+  return options;
+}
+
+function openLogin(spawnImpl = require('node:child_process').spawnSync) {
+  const url = `${DEFAULT_BASE_URL}${LOGIN_PATH}`;
+  const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+  const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+  const result = spawnImpl(command, args, { stdio: 'ignore' });
+  if (result.error || result.status !== 0) throw new Error(`Open ${url} in your browser.`);
+  return url;
+}
+
+function line(value, fallback) {
+  const text = String(value || '').trim();
+  return text || fallback;
+}
+
+function formatBrief(payload) {
+  const rows = Array.isArray(payload.opportunities) ? payload.opportunities : [];
+  const lines = ['# TenderLead daily brief', '', `Generated: ${line(payload.generated_at, 'Not recorded')}`, `Plan: ${line(payload.tier, 'Not recorded')}`, '', '## Opportunities', ''];
+  if (!rows.length) lines.push('No current scored opportunities.');
+  for (const row of rows) {
+    const score = Number.isFinite(Number(row.score)) ? ` ${Math.round(Number(row.score))}/100` : '';
+    lines.push(`- **${line(row.recommendation, 'alert').toUpperCase()}${score}** ${line(row.title, 'Untitled notice')}`);
+    lines.push(`  ${line(row.buyer, 'Buyer not listed')} · ${line(row.source, 'Source not recorded')} · Deadline: ${line(row.deadline, 'Not recorded')}`);
+    if (Array.isArray(row.reasoning) && row.reasoning.length) lines.push(`  Why: ${row.reasoning.slice(0, 3).map(String).join(' ')}`);
+  }
+  lines.push('', 'This response is current TenderLead data. It does not prove email inbox delivery or replace bid judgement.');
+  return lines.join('\n');
+}
+
+async function fetchBrief(_options, fetchImpl = fetch) {
+  const token = process.env.TENDERLEAD_API_TOKEN;
+  if (!token) throw new Error('TENDERLEAD_API_TOKEN is required');
+  const response = await fetchImpl(`${DEFAULT_BASE_URL}/v1/briefs/daily`, {
+    headers: { Accept: 'application/json', Authorization: `Bearer ${token}` },
+  });
+  const body = await response.json().catch(() => ({}));
+  if (!response.ok) throw new Error(body.error || `TenderLead API failed: ${response.status}`);
+  return body;
+}
+
+async function main() {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) return console.log(usage());
+  const options = parseArgs(process.argv);
+  if (options.command === 'login') {
+    openLogin();
+    console.log('TenderLead Settings opened. Sign in, create a CLI token, then set TENDERLEAD_API_TOKEN in your shell.');
+    return;
+  }
+  const brief = await fetchBrief(options);
+  console.log(options.json ? JSON.stringify(brief, null, 2) : formatBrief(brief));
+}
+
+if (require.main === module) {
+  main().catch((error) => { console.error(error.message); process.exitCode = 1; });
+}
+
+module.exports = { parseArgs, openLogin, formatBrief, fetchBrief };

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@tenderlead/cli",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Read-only TenderLead daily briefing CLI",
+  "homepage": "https://tenderlead.co.uk",
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "tenderlead": "bin/tenderlead.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}