@popoverai/dotrequirements 0.23.0 → 0.24.1

package/dist/commands/init.js

@@ -1,19 +1,20 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { detectProjectName } from '../utils/project-name.js';
-import { ensureGitignore } from '../utils/gitignore.js';
-import { generateRequirementsReadme } from '../templates/requirements-readme.js';
-import { generateExampleRequirements } from '../templates/example-requirements.js';
-import { promptChoice, promptConfirm } from '../utils/prompts.js';
-import { mcpSetupCommand } from './mcp-setup.js';
-import { pullCommand } from './pull.js';
-import { executeOAuthFlow } from '../utils/oauth-flow.js';
-import { ConvexHttpClient } from 'convex/browser';
-import { getConvexUrl } from '../config.js';
-import { api } from '../convex.js';
-import { brand } from '../utils/brand.js';
-import { selectProject, getOrCreateProjectSecret, promptExpiryDays } from '../utils/project-selector.js';
-import { writeProjectSettings, findProjectRoot } from '../utils/project-settings.js';
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ConvexHttpClient } from "convex/browser";
+import { getConvexUrl } from "../config.js";
+import { api } from "../convex.js";
+import { generateStyleGuideBody } from "../requirements/style-guide.js";
+import { generateExampleRequirements } from "../templates/example-requirements.js";
+import { generateRequirementsReadme } from "../templates/requirements-readme.js";
+import { brand } from "../utils/brand.js";
+import { ensureGitignore } from "../utils/gitignore.js";
+import { executeOAuthFlow } from "../utils/oauth-flow.js";
+import { detectProjectName } from "../utils/project-name.js";
+import { getOrCreateProjectSecret, promptExpiryDays, selectProject, } from "../utils/project-selector.js";
+import { findProjectRoot, writeProjectSettings, } from "../utils/project-settings.js";
+import { promptChoice, promptConfirm } from "../utils/prompts.js";
+import { aiSetupCommand } from "./ai-setup.js";
+import { pullCommand } from "./pull.js";
 export async function initCommand(options = {}) {
     try {
         console.log(`Initializing ${brand} project...\n`);
@@ -21,7 +22,7 @@ export async function initCommand(options = {}) {
         // INIT-2: Check if .requirements/ folder already exists
         const existingProject = findProjectRoot(cwd);
         if (existingProject === cwd) {
-            console.log('This project is already initialized.');
+            console.log("This project is already initialized.");
             console.log('Use "dotrequirements link" to connect or reconnect to cloud.\n');
             return;
         }
@@ -29,27 +30,27 @@ export async function initCommand(options = {}) {
         if (options.invite) {
             const initSucceeded = await inviteFlow(cwd, options.invite);
             if (initSucceeded) {
-                console.log('\nDocumentation: https://docs.dotrequirements.io/getting-started');
-                console.log('By using this service, you agree to our Terms: https://app.dotrequirements.io/terms');
-                const setupMcp = await promptConfirm('\nConfigure AI assistant integration?', true);
+                console.log("\nDocumentation: https://docs.dotrequirements.io/getting-started");
+                console.log("By using this service, you agree to our Terms: https://app.dotrequirements.io/terms");
+                const setupMcp = await promptConfirm("\nConfigure AI assistant integration?", true);
                 if (setupMcp) {
-                    await mcpSetupCommand();
+                    await aiSetupCommand();
                 }
             }
             return;
         }
         // INIT-1: Ask user whether to authenticate
-        const authChoice = await promptChoice('Do you want to authenticate before initializing a project? (Recommended)', [
-            { title: 'Yes', value: 'yes' },
-            { title: 'No', value: 'no' },
+        const authChoice = await promptChoice("Do you want to authenticate before initializing a project? (Recommended)", [
+            { title: "Yes", value: "yes" },
+            { title: "No", value: "no" },
         ]);
         if (!authChoice) {
             // INIT-1.3: User cancelled
-            console.log('Initialization cancelled.');
+            console.log("Initialization cancelled.");
             return;
         }
         let initSucceeded;
-        if (authChoice === 'no') {
+        if (authChoice === "no") {
             // INIT-3: Local-only workflow
             initSucceeded = await localOnlyFlow(cwd);
         }
@@ -57,22 +58,22 @@ export async function initCommand(options = {}) {
             // INIT-17+: Authenticated workflow
             initSucceeded = await authenticatedFlow(cwd, options);
         }
-        console.log('\nDocumentation: https://docs.dotrequirements.io/getting-started');
-        console.log('By using this service, you agree to our Terms: https://app.dotrequirements.io/terms');
+        console.log("\nDocumentation: https://docs.dotrequirements.io/getting-started");
+        console.log("By using this service, you agree to our Terms: https://app.dotrequirements.io/terms");
         // Offer to configure AI assistant integration after successful init
         if (initSucceeded) {
-            const setupMcp = await promptConfirm('\nConfigure AI assistant integration?', true);
+            const setupMcp = await promptConfirm("\nConfigure AI assistant integration?", true);
             if (setupMcp) {
-                await mcpSetupCommand();
+                await aiSetupCommand();
             }
         }
     }
     catch (error) {
         console.error(`\n✗ Error: ${error instanceof Error ? error.message : String(error)}`);
         // INIT-11: Network error guidance
-        if (error instanceof Error && error.message.includes('fetch')) {
-            console.error('\nCheck your internet connection and try again.');
-            console.error('If the problem persists, visit https://status.convex.dev');
+        if (error instanceof Error && error.message.includes("fetch")) {
+            console.error("\nCheck your internet connection and try again.");
+            console.error("If the problem persists, visit https://status.convex.dev");
         }
         process.exit(1);
     }
@@ -82,30 +83,31 @@ export async function initCommand(options = {}) {
  * Returns true if project was created successfully
  */
 async function localOnlyFlow(cwd) {
-    console.log('\nInitializing local project...');
+    console.log("\nInitializing local project...");
     // INIT-3.0: Create .requirements/ directory
-    const requirementsDir = path.join(cwd, '.requirements');
+    const requirementsDir = path.join(cwd, ".requirements");
     if (!fs.existsSync(requirementsDir)) {
         fs.mkdirSync(requirementsDir, { recursive: true });
-        console.log('✓ Created .requirements/ directory');
+        console.log("✓ Created .requirements/ directory");
     }
     // Create README and example files
-    const readmePath = path.join(requirementsDir, 'README.md');
+    const readmePath = path.join(requirementsDir, "README.md");
     fs.writeFileSync(readmePath, generateRequirementsReadme());
-    console.log('✓ Created .requirements/README.md');
-    const examplePath = path.join(requirementsDir, 'example.requirements.md');
+    console.log("✓ Created .requirements/README.md");
+    const examplePath = path.join(requirementsDir, "example.requirements.md");
     if (!fs.existsSync(examplePath)) {
-        fs.writeFileSync(examplePath, generateExampleRequirements('local'));
-        console.log('✓ Created .requirements/example.requirements.md');
+        fs.writeFileSync(examplePath, generateExampleRequirements("local"));
+        console.log("✓ Created .requirements/example.requirements.md");
     }
+    scaffoldStyleMd(requirementsDir);
     // INIT-5.2: Update .gitignore
     ensureGitignore(cwd);
-    console.log('✓ Updated .gitignore\n');
+    console.log("✓ Updated .gitignore\n");
     // INIT-3.1: No credentials written (local-only)
     // INIT-3.2, INIT-3.3: Show guidance
-    console.log('Next steps:');
-    console.log('  1. Create requirements in .requirements/ directory');
-    console.log('  2. Add the test harness to your test setup (see README)');
+    console.log("Next steps:");
+    console.log("  1. Create requirements in .requirements/ directory");
+    console.log("  2. Add the test harness to your test setup (see README)");
     console.log('  3. Run "dotrequirements link" to connect to cloud features');
     return true;
 }
@@ -123,8 +125,8 @@ async function authenticatedFlow(cwd, options) {
     }
     catch (error) {
         // INIT-17.3: OAuth failed
-        console.error('\nAuthentication failed:', error instanceof Error ? error.message : String(error));
-        console.log('Please try again later.\n');
+        console.error("\nAuthentication failed:", error instanceof Error ? error.message : String(error));
+        console.log("Please try again later.\n");
         return false;
     }
     // Set up authenticated client using the session token
@@ -134,16 +136,16 @@ async function authenticatedFlow(cwd, options) {
     const selectedTeam = await selectTeam(client);
     if (selectedTeam === undefined) {
         // User cancelled
-        console.log('Initialization cancelled.');
+        console.log("Initialization cancelled.");
         return false;
     }
     // INIT-7: Choose between create and connect
     const projectChoice = await chooseProjectAction(client, selectedTeam.teamId);
     if (!projectChoice) {
-        console.log('Initialization cancelled.');
+        console.log("Initialization cancelled.");
         return false;
     }
-    if (projectChoice === 'create') {
+    if (projectChoice === "create") {
         await createNewProjectFlow(cwd, client, selectedTeam, options);
     }
     else {
@@ -158,24 +160,24 @@ async function authenticatedFlow(cwd, options) {
  * - undefined if user cancelled
  */
 async function selectTeam(client) {
-    console.log('Fetching your teams...\n');
+    console.log("Fetching your teams...\n");
     // INIT-18.0: Ensure user has a default team if they don't have any
     await client.mutation(api.teams.mutations.ensureDefaultTeam, {});
     // Query all teams for the authenticated user
-    const teams = await client.query(api.teams.queries.listForUserWithUsage);
+    const teams = (await client.query(api.teams.queries.listForUserWithUsage));
     if (teams.length === 0) {
-        console.log('\nYou are not a member of any teams.');
-        console.log('To create a new team, visit: https://app.dotrequirements.io/teams/new');
+        console.log("\nYou are not a member of any teams.");
+        console.log("To create a new team, visit: https://app.dotrequirements.io/teams/new");
         console.log('After creating your team, run "dotrequirements init" again.\n');
         process.exit(0);
     }
     // INIT-18.1, INIT-18.2, INIT-18.3: Build team selection options with usage display
     const teamChoices = teams.map((team) => {
         const limitDisplay = team.projectLimit === -1
-            ? 'unlimited'
+            ? "unlimited"
             : `${team.projectCount}/${team.projectLimit}`;
         // INIT-18.3: Mark teams at capacity
-        const capacityMarker = team.isAtCapacity ? ' [at capacity]' : '';
+        const capacityMarker = team.isAtCapacity ? " [at capacity]" : "";
         return {
             title: `${team.name} (${team.tierName} - ${limitDisplay} projects)${capacityMarker}`,
             value: team.teamId,
@@ -185,23 +187,23 @@ async function selectTeam(client) {
     // INIT-18.4: Add "Create new team" option if user can create one
     // (Check if user is already admin of a free team - simplified to always show for now)
     teamChoices.push({
-        title: 'Create new team',
-        value: 'CREATE_NEW_TEAM',
+        title: "Create new team",
+        value: "CREATE_NEW_TEAM",
         disabled: false,
     });
-    const selectedTeamId = await promptChoice('Select a team for this project:', teamChoices);
+    const selectedTeamId = await promptChoice("Select a team for this project:", teamChoices);
     if (!selectedTeamId) {
         return undefined;
     }
     // INIT-14: Handle selection of at-capacity team (defensive check)
     const selectedTeam = teams.find((t) => t.teamId === selectedTeamId);
-    if (selectedTeam && selectedTeam.isAtCapacity) {
-        console.error('\n✗ This team is at its project limit. Please select a different team or create a new one.\n');
+    if (selectedTeam?.isAtCapacity) {
+        console.error("\n✗ This team is at its project limit. Please select a different team or create a new one.\n");
         return await selectTeam(client);
     }
     // INIT-15: Handle "Create new team" selection
-    if (selectedTeamId === 'CREATE_NEW_TEAM') {
-        console.log('\nTo create a new team, visit: https://app.dotrequirements.io/teams/new');
+    if (selectedTeamId === "CREATE_NEW_TEAM") {
+        console.log("\nTo create a new team, visit: https://app.dotrequirements.io/teams/new");
         console.log('After creating your team, run "dotrequirements init" again.\n');
         process.exit(0);
     }
@@ -215,16 +217,18 @@ async function selectTeam(client) {
  */
 async function chooseProjectAction(client, teamId) {
     // INIT-7.3: Check if team has existing projects the user can access
-    const projectsWithSecrets = await client.query(api.projectSecrets.queries.listOwnSecretsForTeam, { target: { type: 'team', id: teamId } });
+    const projectsWithSecrets = (await client.query(api.projectSecrets.queries.listOwnSecretsForTeam, 
+    // biome-ignore lint/suspicious/noExplicitAny: CLI workspace doesn't import convex's branded Id<"teams"> type; the runtime value is a plain string the convex server validates.
+    { target: { type: "team", id: teamId } }));
     if (projectsWithSecrets.length === 0) {
         // No existing projects, only offer create
-        const confirmed = await promptConfirm('This team has no projects. Create a new one?', true);
-        return confirmed ? 'create' : undefined;
+        const confirmed = await promptConfirm("This team has no projects. Create a new one?", true);
+        return confirmed ? "create" : undefined;
     }
     // INIT-7.0: Offer both options
-    return await promptChoice('What would you like to do?', [
-        { title: 'Create a new project', value: 'create' },
-        { title: 'Connect to an existing project', value: 'connect' },
+    return await promptChoice("What would you like to do?", [
+        { title: "Create a new project", value: "create" },
+        { title: "Connect to an existing project", value: "connect" },
     ]);
 }
 /**
@@ -234,33 +238,33 @@ async function createNewProjectFlow(cwd, client, team, options) {
     // INIT-4.0: Detect/prompt for project name
     const projectName = await detectProjectName({ name: options.name });
     console.log(`Project name: ${projectName}\n`);
-    console.log('Creating cloud project...');
+    console.log("Creating cloud project...");
     // INIT-4.1: Create project in cloud (no longer auto-creates secret)
-    const result = await client.mutation(api.projects.mutations.create, {
+    const result = (await client.mutation(api.projects.mutations.create, {
         name: projectName,
         teamId: team.teamId,
-    });
+    }));
     const projectId = result.slug;
     console.log(`✓ Cloud project created: ${projectId}`);
     // AUTHZ-3: Prompt for secret expiry (paid tier only)
     const expiryDays = await promptExpiryDays(team.tier);
     // Get secret for the newly created project
-    console.log('Getting project credentials...');
+    console.log("Getting project credentials...");
     const secretResult = await getOrCreateProjectSecret(client, result.projectId, expiryDays);
     const secret = secretResult.secret;
-    console.log('✓ Created project secret');
+    console.log("✓ Created project secret");
     // INIT-4.2: Write credentials to project-settings.json
     writeProjectSettings(cwd, { projectId, projectSecret: secret });
-    console.log('✓ Wrote credentials to .requirements/project-settings.json');
+    console.log("✓ Wrote credentials to .requirements/project-settings.json");
     // INIT-5.0, INIT-5.1: Create directory structure (if not already created by writeProjectSettings)
     await createRequirementsDirectory(cwd, projectId);
     // INIT-5.2: Update .gitignore
     ensureGitignore(cwd);
-    console.log('✓ Updated .gitignore\n');
+    console.log("✓ Updated .gitignore\n");
     // INIT-4.3: Show guidance
-    console.log('Next steps:');
-    console.log('  1. Create requirements in .requirements/ directory');
-    console.log('  2. Add the test harness to your test setup (see README)');
+    console.log("Next steps:");
+    console.log("  1. Create requirements in .requirements/ directory");
+    console.log("  2. Add the test harness to your test setup (see README)");
 }
 /**
  * INIT-6, INIT-16: Connect to an existing project
@@ -269,39 +273,39 @@ async function connectExistingProjectFlow(cwd, client, team) {
     // INIT-6.0, INIT-16.0: Select project from team
     const selectedProject = await selectProject(client, team.teamId);
     if (!selectedProject) {
-        console.log('Initialization cancelled.');
+        console.log("Initialization cancelled.");
         return;
     }
     // AUTHZ-3: Prompt for secret expiry (paid tier only, if creating new secret)
     const expiryDays = await promptExpiryDays(team.tier);
     // INIT-16.1: Get or create secret for this project
-    console.log('\nGetting project credentials...');
+    console.log("\nGetting project credentials...");
     const secretResult = await getOrCreateProjectSecret(client, selectedProject.projectId, expiryDays);
     const projectId = selectedProject.projectSlug || selectedProject.projectId;
     const secret = secretResult.secret;
     if (secretResult.created) {
-        console.log('✓ Created new project secret');
+        console.log("✓ Created new project secret");
     }
     else {
-        console.log('✓ Retrieved existing project secret');
+        console.log("✓ Retrieved existing project secret");
     }
     // INIT-6.1: Write credentials to project-settings.json
     writeProjectSettings(cwd, { projectId, projectSecret: secret });
-    console.log('✓ Wrote credentials to .requirements/project-settings.json');
+    console.log("✓ Wrote credentials to .requirements/project-settings.json");
     // Create directory structure
     await createRequirementsDirectory(cwd, projectId);
     // Update .gitignore
     ensureGitignore(cwd);
-    console.log('✓ Updated .gitignore\n');
+    console.log("✓ Updated .gitignore\n");
     // INIT-6.2: Pull existing requirements from cloud
-    console.log('Pulling requirements from cloud...');
+    console.log("Pulling requirements from cloud...");
     await pullCommand({ project: projectId });
     console.log(`\n✓ Successfully connected to project: ${selectedProject.projectName}`);
     console.log(`  Project ID: ${projectId}`);
     // INIT-6.3: Show guidance
-    console.log('\nNext steps:');
-    console.log('  1. Review the requirements in .requirements/');
-    console.log('  2. Add the test harness to your test setup (see README)');
+    console.log("\nNext steps:");
+    console.log("  1. Review the requirements in .requirements/");
+    console.log("  2. Add the test harness to your test setup (see README)");
 }
 /**
  * MEMBERSHIP-18: Invite flow - join a team using an invite token
@@ -310,18 +314,20 @@ async function connectExistingProjectFlow(cwd, client, team) {
 async function inviteFlow(cwd, token) {
     // MEMBERSHIP-18.0: Validate token before auth (no auth needed for this query)
     const client = new ConvexHttpClient(getConvexUrl());
-    console.log('Validating invite token...');
-    const inviteInfo = await client.query(api.teamInvites.queries.getInviteInfo, { token });
+    console.log("Validating invite token...");
+    const inviteInfo = await client.query(api.teamInvites.queries.getInviteInfo, {
+        token,
+    });
     // MEMBERSHIP-18.3: Handle invalid tokens
     if (!inviteInfo.valid) {
         const errorMessages = {
-            invalid: 'This invite token is not valid.',
-            expired: 'This invite token has expired.',
-            already_used: 'This invite token has already been used.',
+            invalid: "This invite token is not valid.",
+            expired: "This invite token has expired.",
+            already_used: "This invite token has already been used.",
         };
-        const message = errorMessages[inviteInfo.error] || 'Invalid invite token.';
+        const message = errorMessages[inviteInfo.error] || "Invalid invite token.";
         console.error(`\n✗ ${message}`);
-        console.log('Please ask the team admin for a new invite link.\n');
+        console.log("Please ask the team admin for a new invite link.\n");
         return false;
     }
     console.log(`\nYou've been invited to join team "${inviteInfo.teamName}"\n`);
@@ -332,8 +338,8 @@ async function inviteFlow(cwd, token) {
         console.log();
     }
     catch (error) {
-        console.error('\nAuthentication failed:', error instanceof Error ? error.message : String(error));
-        console.log('Please try again later.\n');
+        console.error("\nAuthentication failed:", error instanceof Error ? error.message : String(error));
+        console.log("Please try again later.\n");
         return false;
     }
     // Set up authenticated client
@@ -348,7 +354,7 @@ async function inviteFlow(cwd, token) {
     }
     catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);
-        if (errorMessage.includes('already a member')) {
+        if (errorMessage.includes("already a member")) {
             console.log(`Already a member of "${inviteInfo.teamName}"`);
         }
         else {
@@ -358,65 +364,74 @@ async function inviteFlow(cwd, token) {
     // MEMBERSHIP-18.1.0: Select project from team
     const teamId = inviteInfo.teamId;
     // Get team tier for secret expiry prompt
-    const teams = await client.query(api.teams.queries.listForUserWithUsage);
+    const teams = (await client.query(api.teams.queries.listForUserWithUsage));
     const team = teams.find((t) => t.teamId === teamId);
-    const tier = team?.tier || 'free';
+    const tier = team?.tier || "free";
     const selectedProject = await selectProject(client, teamId);
     if (!selectedProject) {
-        console.log('Initialization cancelled.');
+        console.log("Initialization cancelled.");
         return false;
     }
     // AUTHZ-3: Prompt for secret expiry (paid tier only)
     const expiryDays = await promptExpiryDays(tier);
     // Get or create secret for this project
-    console.log('\nGetting project credentials...');
+    console.log("\nGetting project credentials...");
     const secretResult = await getOrCreateProjectSecret(client, selectedProject.projectId, expiryDays);
     const projectId = selectedProject.projectSlug || selectedProject.projectId;
     const secret = secretResult.secret;
     if (secretResult.created) {
-        console.log('✓ Created new project secret');
+        console.log("✓ Created new project secret");
     }
     else {
-        console.log('✓ Retrieved existing project secret');
+        console.log("✓ Retrieved existing project secret");
     }
     // Write credentials to project-settings.json
     writeProjectSettings(cwd, { projectId, projectSecret: secret });
-    console.log('✓ Wrote credentials to .requirements/project-settings.json');
+    console.log("✓ Wrote credentials to .requirements/project-settings.json");
     // Create directory structure
     await createRequirementsDirectory(cwd, projectId);
     // Update .gitignore
     ensureGitignore(cwd);
-    console.log('✓ Updated .gitignore\n');
+    console.log("✓ Updated .gitignore\n");
     // Pull existing requirements from cloud
-    console.log('Pulling requirements from cloud...');
+    console.log("Pulling requirements from cloud...");
     await pullCommand({ project: projectId });
     console.log(`\n✓ Successfully connected to project: ${selectedProject.projectName}`);
     console.log(`  Project ID: ${projectId}`);
     // Show guidance
-    console.log('\nNext steps:');
-    console.log('  1. Review the requirements in .requirements/');
-    console.log('  2. Add the test harness to your test setup (see README)');
+    console.log("\nNext steps:");
+    console.log("  1. Review the requirements in .requirements/");
+    console.log("  2. Add the test harness to your test setup (see README)");
     return true;
 }
 /**
  * INIT-5: Create .requirements/ directory with README and example
  */
 async function createRequirementsDirectory(cwd, projectId) {
-    const requirementsDir = path.join(cwd, '.requirements');
+    const requirementsDir = path.join(cwd, ".requirements");
     // Directory may already exist from writeProjectSettings
     if (!fs.existsSync(requirementsDir)) {
         fs.mkdirSync(requirementsDir, { recursive: true });
-        console.log('✓ Created .requirements/ directory');
+        console.log("✓ Created .requirements/ directory");
     }
     // INIT-5.0: Always create/update README
-    const readmePath = path.join(requirementsDir, 'README.md');
+    const readmePath = path.join(requirementsDir, "README.md");
     fs.writeFileSync(readmePath, generateRequirementsReadme());
-    console.log('✓ Created .requirements/README.md');
+    console.log("✓ Created .requirements/README.md");
     // INIT-5.1: Create example.requirements.md
-    const examplePath = path.join(requirementsDir, 'example.requirements.md');
+    const examplePath = path.join(requirementsDir, "example.requirements.md");
     if (!fs.existsSync(examplePath)) {
         fs.writeFileSync(examplePath, generateExampleRequirements(projectId));
-        console.log('✓ Created .requirements/example.requirements.md');
+        console.log("✓ Created .requirements/example.requirements.md");
+    }
+    scaffoldStyleMd(requirementsDir);
+}
+function scaffoldStyleMd(requirementsDir) {
+    const stylePath = path.join(requirementsDir, "STYLE.md");
+    if (fs.existsSync(stylePath)) {
+        return;
     }
+    fs.writeFileSync(stylePath, generateStyleGuideBody({ requirements: [], customStyleGuidance: null }));
+    console.log("✓ Created .requirements/STYLE.md");
 }
 //# sourceMappingURL=init.js.map

package/dist/commands/link.js

@@ -1,12 +1,12 @@
-import { promptConfirm, promptChoice } from '../utils/prompts.js';
-import { pullCommand } from './pull.js';
-import { executeOAuthFlow } from '../utils/oauth-flow.js';
-import { ConvexHttpClient } from 'convex/browser';
-import { getConvexUrl } from '../config.js';
-import { brand } from '../utils/brand.js';
-import { selectTeam, selectProject, getOrCreateProjectSecret, promptExpiryDays } from '../utils/project-selector.js';
-import { findProjectRoot, readProjectSettings, writeProjectSettings, } from '../utils/project-settings.js';
-import { ensureGitignore } from '../utils/gitignore.js';
+import { ConvexHttpClient } from "convex/browser";
+import { getConvexUrl } from "../config.js";
+import { brand } from "../utils/brand.js";
+import { ensureGitignore } from "../utils/gitignore.js";
+import { executeOAuthFlow } from "../utils/oauth-flow.js";
+import { getOrCreateProjectSecret, promptExpiryDays, selectProject, selectTeam, } from "../utils/project-selector.js";
+import { findProjectRoot, readProjectSettings, writeProjectSettings, } from "../utils/project-settings.js";
+import { promptChoice, promptConfirm } from "../utils/prompts.js";
+import { pullCommand } from "./pull.js";
 /**
  * Link command - connect or reconnect local project to cloud.
  *
@@ -26,7 +26,7 @@ export async function linkCommand() {
         // LINK-1: Check if .requirements/ folder exists
         const projectRoot = findProjectRoot(cwd);
         if (!projectRoot || projectRoot !== cwd) {
-            console.log('No .requirements/ folder found.');
+            console.log("No .requirements/ folder found.");
             console.log('Run "dotrequirements init" to initialize a project first.\n');
             return;
         }
@@ -52,8 +52,8 @@ export async function linkCommand() {
             console.log();
         }
         catch (error) {
-            console.error('\nAuthentication failed:', error instanceof Error ? error.message : String(error));
-            console.log('Please try again later.\n');
+            console.error("\nAuthentication failed:", error instanceof Error ? error.message : String(error));
+            console.log("Please try again later.\n");
             return;
         }
         // Set up authenticated client using the session token
@@ -62,7 +62,7 @@ export async function linkCommand() {
         // LINK-4: Select team
         const selectedTeam = await selectTeam(client);
         if (!selectedTeam) {
-            console.log('Link cancelled.');
+            console.log("Link cancelled.");
             return;
         }
         // LINK-5: Select project
@@ -74,37 +74,37 @@ export async function linkCommand() {
         // AUTHZ-3: Prompt for secret expiry (paid tier only)
         const expiryDays = await promptExpiryDays(selectedTeam.tier);
         // LINK-5.3: Get or create secret for this project
-        console.log('\nGetting project credentials...');
+        console.log("\nGetting project credentials...");
         const secretResult = await getOrCreateProjectSecret(client, selectedProject.projectId, expiryDays);
         const projectId = selectedProject.projectSlug || selectedProject.projectId;
         const secret = secretResult.secret;
         if (secretResult.created) {
-            console.log('✓ Created new project secret');
+            console.log("✓ Created new project secret");
         }
         else {
-            console.log('✓ Retrieved existing project secret');
+            console.log("✓ Retrieved existing project secret");
         }
         // LINK-6: Write credentials to project-settings.json
         writeProjectSettings(projectRoot, { projectId, projectSecret: secret });
         ensureGitignore(projectRoot);
-        console.log('✓ Wrote credentials to .requirements/project-settings.json');
+        console.log("✓ Wrote credentials to .requirements/project-settings.json");
         // LINK-7: Optionally pull requirements
-        const shouldPull = await promptConfirm('Pull requirements from cloud now?', true);
+        const shouldPull = await promptConfirm("Pull requirements from cloud now?", true);
         if (shouldPull) {
-            console.log('\nPulling requirements...');
+            console.log("\nPulling requirements...");
             await pullCommand({ project: projectId });
         }
         // LINK-7.2: Success message
         console.log(`\n✓ Successfully linked to project: ${selectedProject.projectName}`);
         console.log(`  Project ID: ${projectId}`);
-        console.log('\nDocumentation: https://docs.dotrequirements.io/getting-started');
+        console.log("\nDocumentation: https://docs.dotrequirements.io/getting-started");
     }
     catch (error) {
         console.error(`\n✗ Error: ${error instanceof Error ? error.message : String(error)}`);
         // LINK-8: Network error guidance
-        if (error instanceof Error && error.message.includes('fetch')) {
-            console.error('\nCheck your internet connection and try again.');
-            console.error('If the problem persists, visit https://status.convex.dev');
+        if (error instanceof Error && error.message.includes("fetch")) {
+            console.error("\nCheck your internet connection and try again.");
+            console.error("If the problem persists, visit https://status.convex.dev");
         }
         process.exit(1);
     }
@@ -116,12 +116,12 @@ export async function linkCommand() {
  */
 async function handleExistingCredentials(credentials) {
     console.log(`Currently linked to: ${credentials.projectId}\n`);
-    const choice = await promptChoice('What would you like to do?', [
-        { title: 'Refresh credentials for this project', value: 'refresh' },
-        { title: 'Connect to a different project', value: 'different' },
+    const choice = await promptChoice("What would you like to do?", [
+        { title: "Refresh credentials for this project", value: "refresh" },
+        { title: "Connect to a different project", value: "different" },
     ]);
     if (!choice) {
-        console.log('Link cancelled.');
+        console.log("Link cancelled.");
         return false;
     }
     // Both options continue with OAuth flow

package/dist/commands/list.d.ts

@@ -0,0 +1,6 @@
+interface ListOptions {
+    untested?: boolean;
+}
+export declare function listCommand(options: ListOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map