@tenderlead/cli 0.3.0 → 0.4.1

package/README.md

@@ -21,9 +21,13 @@ Sign in with Google or an emailed sign-in link, then create a scoped token under
 
 ```bash
 export TENDERLEAD_API_TOKEN="paste-token-here"
+tenderlead whoami
 tenderlead brief
 ```
 
+`whoami` confirms which account and token the CLI is using (masked email, plan,
+token label, scopes and expiry). It works with any valid token.
+
 Use JSON output for scripts and agents:
 
 ```bash
@@ -106,6 +110,31 @@ For draft workspace edits or evidence-pack workspace state, pass the existing
 request JSON with `--file`. The CLI sets `contract_id` from the command and sends
 the remaining fields to the same handler used by the signed-in product.
 
+### Prepare a checklist from a public tender link
+
+With a Team account and a `workspace:write` token:
+
+```bash
+tenderlead drafts fetch CONTRACT_ID --url "https://www.contractsfinder.service.gov.uk/Notice/NOTICE_ID" > documents.json
+```
+
+This retrieves public PDF/Word attachments from supported official notices
+(Contracts Finder, Find a Tender and Public Contracts Scotland). It returns
+`documents` and `warnings`, without calling a model or saving a draft. Each
+document retains its source URL. Check the text, warnings and complete buyer
+pack before proceeding. Portal-only files still need manual upload.
+
+To build a checklist, put the reviewed `documents` array into a JSON object
+under `preparation_documents`, then run:
+
+```bash
+tenderlead drafts create CONTRACT_ID --file reviewed-documents.json
+```
+
+Checklist generation requires explicit account AI consent and available budget.
+It does not submit a bid or replace saved answers. Imports are limited to five
+documents, 2 MB per file and 60,000 text characters in total.
+
 Commands that replace, import, update or remove saved data ask for a typed
 confirmation. Reviewed automation can pass `--yes`. Run `tenderlead --help` for
 the full command list.

package/bin/tenderlead.js

@@ -17,6 +17,7 @@ function usage() {
   return [
     'Usage:',
     '  tenderlead login',
+    '  tenderlead whoami [--json]',
     '  tenderlead brief [--json]',
     '  tenderlead tenders search [--query <text>] [--recommendation bid|skip] [--all] [--limit <1-50>] [--json]',
     '  tenderlead tender score <contract-id> [--json]',
@@ -44,6 +45,7 @@ function usage() {
     '  tenderlead templates upload --file <path> [--file <path>...] [--role <role>] [--yes] [--json]',
     '  tenderlead templates remove <template-id> [--yes]',
     '  tenderlead drafts list [--json]',
+    '  tenderlead drafts fetch <contract-id> --url <official-tender-url> [--json]',
     '  tenderlead drafts show <contract-id> [--workspace] [--json]',
     '  tenderlead drafts create <contract-id> [--file <request.json>] [--refresh] [--workspace] [--yes] [--json]',
     '  tenderlead drafts export <contract-id> --format text|docx|xlsx --output <path> [--yes]',
@@ -60,6 +62,7 @@ function usage() {
 function parseArgs(argv) {
   const command = argv[2];
   if (command === 'login') return { command: 'login' };
+  if (command === 'whoami') return parseJsonOnlyArgs(argv, 3, { command: 'whoami', json: false });
   if (command === 'brief') {
     const options = { command: 'brief', json: false };
     for (let index = 3; index < argv.length; index += 1) {
@@ -312,13 +315,14 @@ function parseTemplatesArgs(argv) {
 function parseDraftArgs(argv) {
   const action = argv[3];
   if (action === 'list') return parseJsonOnlyArgs(argv, 4, { command: 'drafts', action, json: false });
-  if (!['show', 'create', 'export', 'import'].includes(action)) throw new Error('Use drafts list, show, create, export or import.');
+  if (!['show', 'create', 'export', 'import', 'fetch'].includes(action)) throw new Error('Use drafts list, show, create, export, import or fetch.');
   const contractId = argv[4];
   if (!contractId || contractId.startsWith('--')) throw new Error(`drafts ${action} requires a contract ID`);
   const options = { command: 'drafts', action, contractId, file: null, refresh: false, workspace: false, format: null, output: null, yes: false, json: false };
   for (let index = 5; index < argv.length; index += 1) {
     const arg = argv[index];
-    if (arg === '--json') options.json = true;
+    if (arg === '--url' && action === 'fetch') { options.url = optionValue(argv, index, arg); index += 1; }
+    else if (arg === '--json') options.json = true;
     else if (arg === '--yes') options.yes = true;
     else if (arg === '--refresh') options.refresh = true;
     else if (arg === '--workspace') options.workspace = true;
@@ -329,6 +333,7 @@ function parseDraftArgs(argv) {
   }
   if (action === 'export' && (!['text', 'docx', 'xlsx'].includes(options.format) || !options.output)) throw new Error('drafts export requires --format text|docx|xlsx and --output <path>');
   if (action === 'import' && !options.file) throw new Error('drafts import requires --file <workspace.xlsx>');
+  if (action === 'fetch' && !options.url) throw new Error('drafts fetch requires --url <official-tender-url>');
   return options;
 }
 
@@ -346,6 +351,19 @@ function line(value, fallback) {
   return text || fallback;
 }
 
+function formatWhoami(payload) {
+  const token = payload.token || {};
+  const rows = [
+    ['Account', line(payload.email, 'unknown')],
+    ['Plan', `${line(payload.plan_tier, 'unknown')} (${line(payload.plan_status, 'unknown')})`],
+    ['Token', line(token.label, 'unnamed')],
+    ['Scopes', Array.isArray(token.scopes) && token.scopes.length ? token.scopes.join(', ') : 'none'],
+    ['Expires', token.expires_at ? String(token.expires_at).slice(0, 10) : 'unknown'],
+  ];
+  const width = Math.max(...rows.map(([label]) => label.length));
+  return rows.map(([label, value]) => `${label.padEnd(width)}  ${value}`).join('\n');
+}
+
 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', ''];
@@ -406,6 +424,8 @@ async function apiRequest(path, options = {}, fetchImpl = fetch) {
   return body;
 }
 
+async function fetchWhoami(fetchImpl = fetch) { return apiRequest('/api/cli/whoami', {}, fetchImpl); }
+
 async function fetchBrief(_options, fetchImpl = fetch) {
   return apiRequest('/v1/briefs/daily', {}, fetchImpl);
 }
@@ -689,6 +709,7 @@ async function main() {
     console.log('TenderLead Settings opened. Sign in, create the required scoped token, then set TENDERLEAD_API_TOKEN in your shell.');
     return;
   }
+  if (options.command === 'whoami') return printPayload(await fetchWhoami(), options.json, formatWhoami);
   if (options.command === 'brief') {
     const brief = await fetchBrief(options);
     console.log(options.json ? JSON.stringify(brief, null, 2) : formatBrief(brief));
@@ -756,6 +777,7 @@ async function main() {
     return printPayload(await removeTemplate(options.id), options.json, () => `Removed bid template ${options.id}.`);
   }
   if (options.command === 'drafts') {
+    if (options.action === 'fetch') return printPayload(await apiRequest('/v1/drafts', {method: 'POST', body: JSON.stringify({contract_id: options.contractId, preparation_url: options.url})}), true);
     if (options.action === 'list') {
       const payload = await fetchDrafts();
       return printPayload(payload, options.json, value => formatList('TenderLead bid drafts', value.drafts || [], row => `${line(row.title, 'Untitled')} · ${line(row.contract_id, 'unknown')}`));
@@ -821,7 +843,7 @@ if (require.main === module) {
 }
 
 module.exports = {
-  parseArgs, openLogin, formatBrief, formatTenders, formatScore, fetchBrief, searchTenders, scoreTender, fetchProfile, updateProfile,
+  parseArgs, openLogin, fetchWhoami, formatWhoami, formatBrief, formatTenders, formatScore, fetchBrief, searchTenders, scoreTender, fetchProfile, updateProfile,
   validateProfile, readProfileFile, profileTemplate, profileDiff, formatProfile,
   formatProfileDiff, confirmApply, confirmWord, readJsonFile, contentTypeForFile, appendFiles,
   fetchPipeline, addPipelineItem, updatePipelineItem, removePipelineItem, fetchInsights, sendTenderFeedback, sendProductFeedback,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tenderlead/cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "private": false,
   "description": "Run TenderLead tender, profile, pipeline, insight and bid-workspace workflows from the terminal",
   "homepage": "https://tenderlead.co.uk",