lat.md 0.1.2 → 0.1.3

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.3",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "packageManager": "pnpm@10.30.2",

package/templates/AGENTS.md

@@ -53,4 +53,16 @@ lat:
 ### 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.
+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():
+    ...
+```
+
+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.