@popoverai/dotrequirements 0.12.0 → 0.13.0

package/README.md

@@ -32,10 +32,7 @@ Create `*.requirements.md` files in `.requirements/` or colocate them with your
 
 ```markdown
 ---
-projectId: my-project
-version: 1
 document:
-  id: auth-requirements
   title: "Authentication Requirements"
 ---
 
@@ -210,6 +207,15 @@ export async function teardown() {
 
 Alternatively, you can use the default export pattern that returns a teardown function—see the [Vitest globalSetup docs](https://vitest.dev/config/globalsetup).
 
+**Customizing output:** `finalize()` accepts options to control verbosity:
+
+```typescript
+await finalize({ showTestedList: true }); // Include tested requirements
+await finalize({ showSummary: false, showUntestedList: false }); // Quiet mode
+```
+
+By default, only untested requirements are shown. See the [test harness docs](https://dotrequirements.io/tools/test-harness) for all options.
+
 ### Setup with Jest
 
 **jest.config.cjs:**
@@ -290,19 +296,21 @@ After tests complete, a coverage summary prints to the console:
 
 ```
 === Requirements Coverage Report ===
+
 Total Requirements: 12
 Tested Requirements: 10
 Untested Requirements: 2
 Coverage: 83.3%
 
-Tested:
-  ✓ AUTH-LOGIN-1 (A registered user, Jamie, can log in to their account)
-  ✓ AUTH-LOGIN-1.0 (When Jamie provides a valid username and password...)
-  ...
+✓ Tested Requirements:
+  - AUTH-LOGIN-1: A registered user, Jamie, can log in to their account
+  - AUTH-LOGIN-1.0: When Jamie provides a valid username and password...
+
+✗ Untested Requirements:
+  - AUTH-LOGIN-2: A user with two-factor auth must provide an OTP
+  - AUTH-SECURITY-1: Session tokens expire after 8 hours
 
-Untested:
-  ✗ AUTH-LOGIN-2
-  ✗ AUTH-SECURITY-1
+====================================
 ```
 
 #### Cloud Reporting
@@ -346,10 +354,7 @@ src/components/
 
 ```markdown
 ---
-projectId: my-project
-version: 1
 document:
-  id: unique-doc-id
   title: "Document Title"
 ---
 
@@ -380,7 +385,7 @@ AUTH-LOGIN-2: A user with two-factor auth must provide an OTP
 
 ### Format Details
 
-- **Frontmatter**: YAML metadata (`projectId`, `version`, `document`)
+- **Frontmatter**: YAML metadata (only `document.title` required for push)
 - **Headings**: Optional documentation (not parsed as requirement data)
 - **Fenced blocks**: `dotrequirements` blocks contain structured requirement data
 - **First line**: `KEY: content` — the requirement identifier and summary

package/dist/commands/init.js

@@ -48,6 +48,7 @@ export async function initCommand(options = {}) {
             await connectExistingProjectFlow(cwd, envPath);
         }
         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');
     }
     catch (error) {
         console.error(`\n✗ Error: ${error instanceof Error ? error.message : String(error)}`);
@@ -67,6 +68,9 @@ export async function initCommand(options = {}) {
  */
 async function selectTeam(client) {
     console.log('Fetching your teams...\n');
+    // AUTH-24.0: Ensure user has a default team if they don't have any
+    // This handles new users who haven't joined via invite
+    await client.mutation(api.teams.mutations.ensureDefaultTeam, {});
     // INIT-13.0: Query all teams for the authenticated user
     const teams = await client.query(api.teams.queries.listForUserWithUsage);
     if (teams.length === 0) {

package/dist/commands/pull.js

@@ -6,6 +6,7 @@ import { buildRequirementsFile } from '../schema/index.js';
 import { api } from '../convex.js';
 import { isLocalOnlyProject, CLOUD_FEATURES_REQUIRE_AUTH_MESSAGE } from '../utils/local-project.js';
 import { brand } from '../utils/brand.js';
+import { findRequirementsFiles } from '../mcp/requirements.js';
 export async function pullCommand(options) {
     try {
         console.log(`Syncing requirements from ${brand} cloud...`);
@@ -66,13 +67,13 @@ export async function pullCommand(options) {
             console.log('No documents found.');
             return;
         }
-        // Ensure .requirements/ directory exists
+        // Ensure .requirements/ directory exists (for new documents)
         const requirementsDir = path.join(process.cwd(), '.requirements');
         if (!fs.existsSync(requirementsDir)) {
             fs.mkdirSync(requirementsDir, { recursive: true });
         }
-        // Build index of existing files by document ID
-        const existingFilesByDocId = buildDocumentIdIndex(requirementsDir);
+        // Build index of existing files by document ID (search entire workspace)
+        const existingFilesByDocId = await buildDocumentIdIndex(process.cwd());
         // Write each document as a Markdown file
         for (const doc of documents) {
             // Check if an existing file has this document ID
@@ -81,9 +82,7 @@ export async function pullCommand(options) {
             const fileName = path.basename(filePath);
             // Build metadata with pulledAt for conflict detection
             // SYNC-CLI-EDIT-2: pulledAt is compared with cloud updatedAt during push
-            // Use the slug we authenticated with (not the Convex ID from the response)
             const metadata = {
-                projectId: projectId,
                 pulledAt: new Date().toISOString(),
                 version: doc.version,
                 document: {
@@ -122,19 +121,14 @@ function loadProjectIdFromEnv() {
 }
 /**
  * Build an index mapping document IDs to their file paths.
- * Scans existing .requirements.md files and extracts document.id from frontmatter.
+ * Scans existing .requirements.md files across the entire workspace and extracts document.id from frontmatter.
+ * SYNC-DISCOVERY-2.0: Uses the same discovery logic as push and MCP.
  */
-function buildDocumentIdIndex(requirementsDir) {
+async function buildDocumentIdIndex(workspaceRoot) {
     const index = new Map();
-    if (!fs.existsSync(requirementsDir)) {
-        return index;
-    }
-    const files = fs.readdirSync(requirementsDir);
-    for (const file of files) {
-        if (!file.endsWith('.requirements.md')) {
-            continue;
-        }
-        const filePath = path.join(requirementsDir, file);
+    // Use the same file discovery as MCP and push
+    const allFiles = await findRequirementsFiles(workspaceRoot);
+    for (const filePath of allFiles) {
         const docId = extractDocumentIdFromFile(filePath);
         if (docId) {
             index.set(docId, filePath);

package/dist/commands/push.js

@@ -7,6 +7,7 @@ import { api } from '../convex.js';
 import * as readline from 'readline';
 import { isLocalOnlyProject, CLOUD_FEATURES_REQUIRE_AUTH_MESSAGE } from '../utils/local-project.js';
 import { brand } from '../utils/brand.js';
+import { findRequirementsFiles } from '../mcp/requirements.js';
 export async function pushCommand(file, options) {
     try {
         console.log(`Preparing to push requirements to ${brand} cloud...\n`);
@@ -23,11 +24,6 @@ export async function pushCommand(file, options) {
             throw new Error(CLOUD_FEATURES_REQUIRE_AUTH_MESSAGE);
         }
         // Determine which files to push
-        const requirementsDir = path.join(process.cwd(), '.requirements');
-        if (!fs.existsSync(requirementsDir)) {
-            console.log('No .requirements/ directory found. Nothing to push.');
-            return;
-        }
         let filesToPush;
         if (file) {
             // Push specific file
@@ -38,13 +34,11 @@ export async function pushCommand(file, options) {
             filesToPush = [filePath];
         }
         else {
-            // Push all *.requirements.md files in .requirements/
-            const files = fs.readdirSync(requirementsDir);
-            filesToPush = files
-                .filter(f => f.endsWith('.requirements.md'))
-                .map(f => path.join(requirementsDir, f));
+            // SYNC-DISCOVERY-1.0: Push all *.requirements.md files in workspace (not just .requirements/)
+            const workspaceRoot = process.cwd();
+            filesToPush = await findRequirementsFiles(workspaceRoot);
             if (filesToPush.length === 0) {
-                console.log('No *.requirements.md files found in .requirements/. Nothing to push.');
+                console.log('No *.requirements.md files found. Nothing to push.');
                 return;
             }
         }

package/dist/convex.d.ts

@@ -35,6 +35,9 @@ export declare const api: {
         queries: {
             listForUserWithUsage: any;
         };
+        mutations: {
+            ensureDefaultTeam: any;
+        };
     };
     projectSecrets: {
         queries: {

package/dist/convex.js

@@ -37,6 +37,9 @@ export const api = {
         queries: {
             listForUserWithUsage: 'teams/queries:listForUserWithUsage',
         },
+        mutations: {
+            ensureDefaultTeam: 'teams/mutations:ensureDefaultTeam',
+        },
     },
     projectSecrets: {
         queries: {

package/dist/harness/finalize.d.ts

@@ -14,10 +14,16 @@ export interface FinalizeOptions {
     cwd?: string;
     /** Whether to report to cloud (defaults to true) */
     reportToCloud?: boolean;
-    /** Whether to print local report (defaults to true) */
-    printLocalReport?: boolean;
     /** Whether to clean up tracking data on success (defaults to true) */
     cleanup?: boolean;
+    /** Whether to show coverage summary stats (defaults to true) */
+    showSummary?: boolean;
+    /** Whether to show the list of tested requirements (defaults to false) */
+    showTestedList?: boolean;
+    /** Whether to show the list of untested requirements (defaults to true) */
+    showUntestedList?: boolean;
+    /** Whether to show cloud reporting status messages (defaults to true) */
+    showCloudStatus?: boolean;
 }
 export interface FinalizeResult {
     /** Number of unique requirements exercised */

package/dist/harness/finalize.js

@@ -46,19 +46,24 @@ function getCurrentBranch(cwd) {
  *
  * HARNESS-FINALIZE-1: Shows which requirements were tested
  */
-function printLocalReport(testedKeys, lookup) {
+function printLocalReport(testedKeys, lookup, options) {
+    const { showSummary, showTestedList, showUntestedList } = options;
     const allKeys = lookup ? Object.keys(lookup.requirements) : [];
     const untestedKeys = allKeys.filter(key => !testedKeys.includes(key));
     const total = allKeys.length;
     const tested = testedKeys.length;
     const coverage = total > 0 ? ((tested / total) * 100).toFixed(1) : '0.0';
-    let report = '\n=== Requirements Coverage Report ===\n';
-    report += `\nTotal Requirements: ${total}\n`;
-    report += `Tested Requirements: ${tested}\n`;
-    report += `Untested Requirements: ${untestedKeys.length}\n`;
-    report += `Coverage: ${coverage}%\n`;
+    let report = '';
+    // Show summary stats
+    if (showSummary) {
+        report += '\n=== Requirements Coverage Report ===\n';
+        report += `\nTotal Requirements: ${total}\n`;
+        report += `Tested Requirements: ${tested}\n`;
+        report += `Untested Requirements: ${untestedKeys.length}\n`;
+        report += `Coverage: ${coverage}%\n`;
+    }
     // Show tested requirements
-    if (testedKeys.length > 0) {
+    if (showTestedList && testedKeys.length > 0) {
         report += '\n✓ Tested Requirements:\n';
         for (const key of testedKeys) {
             const req = lookup?.requirements[key];
@@ -75,7 +80,7 @@ function printLocalReport(testedKeys, lookup) {
         }
     }
     // Show untested requirements
-    if (untestedKeys.length > 0) {
+    if (showUntestedList && untestedKeys.length > 0) {
         report += '\n✗ Untested Requirements:\n';
         for (const key of untestedKeys) {
             const req = lookup?.requirements[key];
@@ -91,8 +96,12 @@ function printLocalReport(testedKeys, lookup) {
             }
         }
     }
-    report += '\n====================================\n';
-    console.log(report);
+    if (showSummary) {
+        report += '\n====================================\n';
+    }
+    if (report) {
+        console.log(report);
+    }
 }
 /**
  * Production Convex deployment URL
@@ -104,13 +113,15 @@ const CONVEX_URL = 'https://data.dotrequirements.io';
  * HARNESS-FINALIZE-2: Cloud reporting with error tolerance
  * HARNESS-FINALIZE-3: Coverage records include requirement, file, line, branch
  */
-async function reportToConvex(projectRoot, testRunId, aggregated) {
+async function reportToConvex(projectRoot, testRunId, aggregated, showCloudStatus) {
     try {
         // Load credentials
         loadEnvFile(projectRoot);
         const credentials = getProjectCredentials();
         if (!credentials) {
-            console.log('\nℹ️  Skipping cloud coverage reporting (DOTREQUIREMENTS_PROJECT_ID or DOTREQUIREMENTS_PROJECT_SECRET not configured)');
+            if (showCloudStatus) {
+                console.log('\nℹ️  Skipping cloud coverage reporting (DOTREQUIREMENTS_PROJECT_ID or DOTREQUIREMENTS_PROJECT_SECRET not configured)');
+            }
             return { sent: false, count: 0 };
         }
         const { projectId, projectSecret } = credentials;
@@ -125,7 +136,9 @@ async function reportToConvex(projectRoot, testRunId, aggregated) {
         const coverageCache = readCoverageCache(requirementsDir);
         const keysToReport = requirementKeys.filter(key => needsReporting(key, coverageCache));
         if (keysToReport.length === 0) {
-            console.log('\n✓ Coverage unchanged since last run (skipping cloud report)');
+            if (showCloudStatus) {
+                console.log('\n✓ Coverage unchanged since last run (skipping cloud report)');
+            }
             // Still update the cache
             updateCoverageCache(requirementsDir, testRunId, requirementKeys);
             return { sent: false, count: 0 };
@@ -184,7 +197,9 @@ async function reportToConvex(projectRoot, testRunId, aggregated) {
         });
         if (!response.ok) {
             const error = await response.text();
-            console.warn(`\n⚠️  Failed to report coverage to cloud: ${response.status} ${error}`);
+            if (showCloudStatus) {
+                console.warn(`\n⚠️  Failed to report coverage to cloud: ${response.status} ${error}`);
+            }
             return { sent: false, count: 0, error: `${response.status} ${error}` };
         }
         // Check for Convex-level errors in the response body
@@ -201,18 +216,24 @@ async function reportToConvex(projectRoot, testRunId, aggregated) {
             const convexResponse = responseData;
             if (convexResponse.status === 'error') {
                 const errorMsg = convexResponse.errorMessage || 'Unknown Convex error';
-                console.warn(`\n⚠️  Failed to report coverage to cloud: ${errorMsg}`);
+                if (showCloudStatus) {
+                    console.warn(`\n⚠️  Failed to report coverage to cloud: ${errorMsg}`);
+                }
                 return { sent: false, count: 0, error: errorMsg };
             }
         }
-        console.log(`\n✓ Reported ${keysToReport.length} requirement(s) to cloud (branch: ${branch})`);
+        if (showCloudStatus) {
+            console.log(`\n✓ Reported ${keysToReport.length} requirement(s) to cloud (branch: ${branch})`);
+        }
         // Update coverage cache
         updateCoverageCache(requirementsDir, testRunId, requirementKeys);
         return { sent: true, count: keysToReport.length };
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        console.warn(`\n⚠️  Error reporting coverage to cloud: ${errorMessage}`);
+        if (showCloudStatus) {
+            console.warn(`\n⚠️  Error reporting coverage to cloud: ${errorMessage}`);
+        }
         return { sent: false, count: 0, error: errorMessage };
     }
 }
@@ -228,7 +249,7 @@ async function reportToConvex(projectRoot, testRunId, aggregated) {
  * HARNESS-FINALIZE-4: Finalize cleans up after itself
  */
 export async function finalize(options = {}) {
-    const { cwd = process.cwd(), reportToCloud: shouldReportToCloud = true, printLocalReport: shouldPrintLocal = true, cleanup: shouldCleanup = true, } = options;
+    const { cwd = process.cwd(), reportToCloud: shouldReportToCloud = true, cleanup: shouldCleanup = true, showSummary = true, showTestedList = false, showUntestedList = true, showCloudStatus = true, } = options;
     // Priority 1: Use environment variable (cross-process persistence from globalSetup)
     let projectRoot = process.env.DOTREQUIREMENTS_PROJECT_ROOT || null;
     // Priority 2: Find from cwd
@@ -270,13 +291,14 @@ export async function finalize(options = {}) {
         ? (testedKeys.length / totalRequirements) * 100
         : 0;
     // HARNESS-FINALIZE-1: Print local report
+    const shouldPrintLocal = showSummary || showTestedList || showUntestedList;
     if (shouldPrintLocal) {
-        printLocalReport(testedKeys, lookup);
+        printLocalReport(testedKeys, lookup, { showSummary, showTestedList, showUntestedList });
     }
     // HARNESS-FINALIZE-2, HARNESS-FINALIZE-3: Report to cloud
     let cloudResult = { sent: false, count: 0 };
     if (shouldReportToCloud) {
-        cloudResult = await reportToConvex(projectRoot, testRunId, aggregated);
+        cloudResult = await reportToConvex(projectRoot, testRunId, aggregated, showCloudStatus);
     }
     // HARNESS-FINALIZE-4: Clean up tracking data
     if (shouldCleanup && !cloudResult.error) {

package/dist/mcp/index.js

@@ -33,6 +33,17 @@ function getProjectPathsFromEnv() {
 // Get workspace root from environment or default to cwd
 const WORKSPACE_ROOT = process.env.REQUIREMENTS_DIR || process.cwd();
 const PROJECT_PATHS = getProjectPathsFromEnv();
+const STYLE_CHECK_GUIDANCE = `
+
+---
+
+## How to use this feedback
+
+1. **This check is stateless.** It is a "new set of eyes" from any previous feedback rounds — it has no memory of prior suggestions or changes you've already made.
+
+2. **Act on feedback from the posture of "what will make the requirements better."** The severity categories (MUST FIX / SHOULD FIX / COULD IMPROVE) are prioritized for convenience, but unless the user has explicitly told you to ignore lower-priority feedback, go ahead and make any improvements — minor or otherwise. If you believe acting on a specific piece of feedback would make the requirements *worse*, surface that feedback to the user rather than silently ignoring it. Otherwise, just act.
+
+3. **Next steps:** Always run \`validate_requirements\` again after making updates. If you make significant changes based on this feedback, you can run \`style_check\` again — but be aware that will be a fresh set of eyes, not a continued conversation.`;
 // Cache for loaded requirements (refreshed on each tool call for now)
 let cachedRequirements = new Map();
 let cachedDiscoveryResult = null;
@@ -1070,9 +1081,6 @@ ${projectList || '(none found)'}`,
 **Use concise domain prefixes** like \`AUTH-1\`, \`LOGIN-1\`, etc. Start numbering at 1 and increment sequentially.`;
                 }
                 const template = `---
-projectId: "your-project-id"
-pulledAt: "${new Date().toISOString()}"
-version: 1
 document:
   title: "Example Requirements"
 ---
@@ -1280,7 +1288,7 @@ describe(requirement('AUTH-LOGIN-1'), () => {
                         content: [
                             {
                                 type: 'text',
-                                text: `${headline}${pushDetails}\n\n**Metadata:**\n- Project ID: ${parsed.metadata.projectId}\n- Version: ${parsed.metadata.version}\n- Document: ${parsed.metadata.document?.title || '(none)'}\n- Document ID: ${parsed.metadata.document?.id || '(none)'}\n\n**Requirements:** ${reqCount} root requirement(s) found`,
+                                text: `${headline}${pushDetails}\n\n**Metadata:**\n- Version: ${parsed.metadata.version ?? '(none)'}\n- Document: ${parsed.metadata.document?.title || '(none)'}\n- Document ID: ${parsed.metadata.document?.id || '(none)'}\n\n**Requirements:** ${reqCount} root requirement(s) found`,
                             },
                         ],
                     };
@@ -1559,7 +1567,7 @@ describe(requirement('AUTH-LOGIN-1'), () => {
                         content: [
                             {
                                 type: 'text',
-                                text: `# Style Check Results for \`${filePath}\`\n\n${data.feedback}`,
+                                text: `# Style Check Results for \`${filePath}\`\n\n${data.feedback}${STYLE_CHECK_GUIDANCE}`,
                             },
                         ],
                     };

package/dist/schema/conversions.d.ts

@@ -48,10 +48,10 @@ export declare function convexToRequirements(convexReqs: ConvexRequirement[]): R
  */
 export declare function requirementsToConvex(nodes: RequirementNode[], projectId: string, documentId: string): ConvexRequirement[];
 /**
- * Build metadata from project info and pull time.
+ * Build metadata for a requirements file.
  * DOC-HEADER-11.3: When pulling, include defaultPrefix in the frontmatter.
  */
-export declare function buildMetadata(projectId: string, version?: number, document?: {
+export declare function buildMetadata(version?: number, document?: {
     id?: string;
     title: string;
     defaultPrefix?: string;

package/dist/schema/conversions.js

@@ -166,12 +166,11 @@ function flattenNode(node, projectId, rootId, position, result, documentId) {
     });
 }
 /**
- * Build metadata from project info and pull time.
+ * Build metadata for a requirements file.
  * DOC-HEADER-11.3: When pulling, include defaultPrefix in the frontmatter.
  */
-export function buildMetadata(projectId, version = 1, document) {
+export function buildMetadata(version = 1, document) {
     return {
-        projectId,
         pulledAt: new Date().toISOString(),
         version,
         document,

package/dist/schema/schemas.d.ts

@@ -54,13 +54,12 @@ export declare function parseRequirementKey(key: string): {
  */
 export declare function buildRequirementKey(prefix: string, number: number): string;
 /**
- * Metadata block at the top of every requirements file
+ * Metadata block at the top of every requirements file.
+ * Only document.title is required for push; everything else is optional or auto-filled.
  */
 export declare const MetadataSchema: z.ZodObject<{
-    projectId: z.ZodString;
-    projectSlug: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodNumber>;
     pulledAt: z.ZodOptional<z.ZodString>;
-    version: z.ZodNumber;
     document: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         title: z.ZodString;
@@ -75,9 +74,7 @@ export declare const MetadataSchema: z.ZodObject<{
         defaultPrefix?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    version: number;
-    projectId: string;
-    projectSlug?: string | undefined;
+    version?: number | undefined;
     pulledAt?: string | undefined;
     document?: {
         title: string;
@@ -85,9 +82,7 @@ export declare const MetadataSchema: z.ZodObject<{
         defaultPrefix?: string | undefined;
     } | undefined;
 }, {
-    version: number;
-    projectId: string;
-    projectSlug?: string | undefined;
+    version?: number | undefined;
     pulledAt?: string | undefined;
     document?: {
         title: string;
@@ -149,10 +144,8 @@ export type RequirementNode = {
  */
 export declare const RequirementsFileSchema: z.ZodObject<{
     _meta: z.ZodObject<{
-        projectId: z.ZodString;
-        projectSlug: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodNumber>;
         pulledAt: z.ZodOptional<z.ZodString>;
-        version: z.ZodNumber;
         document: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             title: z.ZodString;
@@ -167,9 +160,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;
@@ -177,9 +168,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         } | undefined;
     }, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;
@@ -189,10 +178,8 @@ export declare const RequirementsFileSchema: z.ZodObject<{
     }>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     _meta: z.ZodObject<{
-        projectId: z.ZodString;
-        projectSlug: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodNumber>;
         pulledAt: z.ZodOptional<z.ZodString>;
-        version: z.ZodNumber;
         document: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             title: z.ZodString;
@@ -207,9 +194,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;
@@ -217,9 +202,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         } | undefined;
     }, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;
@@ -229,10 +212,8 @@ export declare const RequirementsFileSchema: z.ZodObject<{
     }>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     _meta: z.ZodObject<{
-        projectId: z.ZodString;
-        projectSlug: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodNumber>;
         pulledAt: z.ZodOptional<z.ZodString>;
-        version: z.ZodNumber;
         document: z.ZodOptional<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             title: z.ZodString;
@@ -247,9 +228,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;
@@ -257,9 +236,7 @@ export declare const RequirementsFileSchema: z.ZodObject<{
             defaultPrefix?: string | undefined;
         } | undefined;
     }, {
-        version: number;
-        projectId: string;
-        projectSlug?: string | undefined;
+        version?: number | undefined;
         pulledAt?: string | undefined;
         document?: {
             title: string;

package/dist/schema/schemas.js

@@ -104,19 +104,16 @@ export function buildRequirementKey(prefix, number) {
 // Metadata Schema
 // =============================================================================
 /**
- * Metadata block at the top of every requirements file
+ * Metadata block at the top of every requirements file.
+ * Only document.title is required for push; everything else is optional or auto-filled.
  */
 export const MetadataSchema = z.object({
-    projectId: z.string(),
-    projectSlug: z.string().optional(), // User-friendly slug (e.g., "quick-fox-123")
-    pulledAt: z.string().optional(), // ISO 8601 timestamp - required for CLI files, optional for IDE
-    version: z.number(),
-    // Optional document association (one file = one document)
+    version: z.number().optional(), // Informational - incremented on push
+    pulledAt: z.string().optional(), // ISO 8601 timestamp - used for conflict detection
     document: z.object({
-        id: z.string().optional(), // Optional - filled by push when creating new document
-        title: z.string(),
-        // DOC-HEADER-11: Default prefix for new requirement keys in this document
-        defaultPrefix: z.string().optional(),
+        id: z.string().optional(), // Cloud document link - filled by push when creating
+        title: z.string(), // Required for push
+        defaultPrefix: z.string().optional(), // Editor hint for new requirement keys
     }).optional(),
 });
 // =============================================================================

package/dist/schema/test-schema.js

@@ -3,7 +3,7 @@
  */
 import { buildRequirementsMarkdown, parseRequirementsFile, buildMetadata } from './index.js';
 // Create test data
-const metadata = buildMetadata('test-project-123', 1);
+const metadata = buildMetadata(1);
 const testRequirements = [
     {
         id: 'REQ123',

package/dist/utils/project-selector.js

@@ -6,6 +6,8 @@ import { api } from '../convex.js';
  */
 export async function selectTeam(client) {
     console.log('Fetching your teams...\n');
+    // AUTH-24.0: Ensure user has a default team if they don't have any
+    await client.mutation(api.teams.mutations.ensureDefaultTeam, {});
     const teams = await client.query(api.teams.queries.listForUserWithUsage);
     if (teams.length === 0) {
         console.log('You are not a member of any teams.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@popoverai/dotrequirements",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Requirements tracking CLI, test harness, and MCP server",
   "type": "module",
   "bin": {