lat.md 0.1.2 → 0.1.4

package/dist/src/cli/index.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+// Suppress deprecation warnings from transitive dependencies unless --verbose
+if (!process.argv.includes('--verbose')) {
+    process.noDeprecation = true;
+}
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -27,7 +31,8 @@ program
     .description('Anchor source code to high-level concepts defined in markdown')
     .version(version)
     .option('--dir <path>', 'project root to look for lat.md in (default: cwd)')
-    .option('--no-color', 'disable color output');
+    .option('--no-color', 'disable color output')
+    .option('--verbose', 'show deprecation warnings and extra diagnostics');
 program
     .command('locate')
     .description('Find sections by id')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lat.md",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "packageManager": "pnpm@10.30.2",

package/templates/AGENTS.md

@@ -50,7 +50,24 @@ lat:
 
 ## User login
 ### Rejects expired tokens
+Tokens past their expiry timestamp are rejected with 401, even if otherwise valid.
+
 ### Handles missing password
+Login request without a password field returns 400 with a descriptive error.
+```
+
+Every section MUST have a description — at least one sentence explaining what the test verifies and why. Empty sections with just a heading are not acceptable.
+
+Each test in code should reference its spec with exactly one comment placed next to the relevant test — not at the top of the file:
+
+```python
+# @lat: [[tests#User login#Rejects expired tokens]]
+def test_rejects_expired_tokens():
+    ...
+
+# @lat: [[tests#User login#Handles missing password]]
+def test_handles_missing_password():
+    ...
 ```
 
-Each test in code should reference its spec: `// @lat: [[tests#User login#Rejects expired tokens]]`. Running `lat check` will flag any spec section not covered by a code reference, and any code reference pointing to a nonexistent section.
+Do not duplicate refs. One `@lat:` comment per spec section, placed at the test that covers it. `lat check` will flag any spec section not covered by a code reference, and any code reference pointing to a nonexistent section.