feed-the-machine 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (224) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +170 -170
  3. package/bin/generate-manifest.mjs +463 -463
  4. package/bin/install.mjs +491 -491
  5. package/docs/HOOKS.md +243 -243
  6. package/docs/INBOX.md +233 -233
  7. package/ftm/SKILL.md +122 -122
  8. package/ftm-audit/SKILL.md +623 -541
  9. package/ftm-audit/references/protocols/PROJECT-PATTERNS.md +91 -91
  10. package/ftm-audit/references/protocols/RUNTIME-WIRING.md +66 -66
  11. package/ftm-audit/references/protocols/WIRING-CONTRACTS.md +135 -135
  12. package/ftm-audit/references/strategies/AUTO-FIX-STRATEGIES.md +69 -69
  13. package/ftm-audit/references/templates/REPORT-FORMAT.md +96 -96
  14. package/ftm-audit/scripts/run-knip.sh +23 -23
  15. package/ftm-audit.yml +2 -2
  16. package/ftm-brainstorm/SKILL.md +498 -498
  17. package/ftm-brainstorm/evals/evals.json +100 -100
  18. package/ftm-brainstorm/evals/promptfoo.yaml +109 -109
  19. package/ftm-brainstorm/references/agent-prompts.md +224 -224
  20. package/ftm-brainstorm/references/plan-template.md +121 -121
  21. package/ftm-brainstorm.yml +2 -2
  22. package/ftm-browse/SKILL.md +454 -454
  23. package/ftm-browse/daemon/browser-manager.ts +206 -206
  24. package/ftm-browse/daemon/bun.lock +30 -30
  25. package/ftm-browse/daemon/cli.ts +347 -347
  26. package/ftm-browse/daemon/commands.ts +410 -410
  27. package/ftm-browse/daemon/main.ts +357 -357
  28. package/ftm-browse/daemon/package.json +17 -17
  29. package/ftm-browse/daemon/server.ts +189 -189
  30. package/ftm-browse/daemon/snapshot.ts +519 -519
  31. package/ftm-browse/daemon/tsconfig.json +22 -22
  32. package/ftm-browse.yml +4 -4
  33. package/ftm-capture/SKILL.md +370 -370
  34. package/ftm-capture.yml +4 -4
  35. package/ftm-codex-gate/SKILL.md +361 -361
  36. package/ftm-codex-gate.yml +2 -2
  37. package/ftm-config/SKILL.md +345 -345
  38. package/ftm-config.default.yml +82 -80
  39. package/ftm-config.yml +2 -2
  40. package/ftm-council/SKILL.md +416 -416
  41. package/ftm-council/references/prompts/CLAUDE-INVESTIGATION.md +60 -60
  42. package/ftm-council/references/prompts/CODEX-INVESTIGATION.md +58 -58
  43. package/ftm-council/references/prompts/GEMINI-INVESTIGATION.md +58 -58
  44. package/ftm-council/references/prompts/REBUTTAL-TEMPLATE.md +57 -57
  45. package/ftm-council/references/protocols/PREREQUISITES.md +47 -47
  46. package/ftm-council/references/protocols/STEP-0-FRAMING.md +46 -46
  47. package/ftm-council.yml +2 -2
  48. package/ftm-dashboard/SKILL.md +163 -163
  49. package/ftm-dashboard.yml +4 -4
  50. package/ftm-debug/SKILL.md +1037 -1037
  51. package/ftm-debug/references/phases/PHASE-0-INTAKE.md +58 -58
  52. package/ftm-debug/references/phases/PHASE-1-TRIAGE.md +46 -46
  53. package/ftm-debug/references/phases/PHASE-2-WAR-ROOM-AGENTS.md +279 -279
  54. package/ftm-debug/references/phases/PHASE-3-TO-6-EXECUTION.md +436 -436
  55. package/ftm-debug/references/protocols/BLACKBOARD.md +86 -86
  56. package/ftm-debug/references/protocols/EDGE-CASES.md +103 -103
  57. package/ftm-debug.yml +2 -2
  58. package/ftm-diagram/SKILL.md +277 -277
  59. package/ftm-diagram.yml +2 -2
  60. package/ftm-executor/SKILL.md +777 -767
  61. package/ftm-executor/references/STYLE-TEMPLATE.md +73 -73
  62. package/ftm-executor/references/phases/PHASE-0-VERIFICATION.md +62 -62
  63. package/ftm-executor/references/phases/PHASE-2-AGENT-ASSEMBLY.md +34 -34
  64. package/ftm-executor/references/phases/PHASE-3-WORKTREES.md +38 -38
  65. package/ftm-executor/references/phases/PHASE-4-5-AUDIT.md +72 -72
  66. package/ftm-executor/references/phases/PHASE-4-DISPATCH.md +66 -66
  67. package/ftm-executor/references/phases/PHASE-5-5-CODEX-GATE.md +73 -73
  68. package/ftm-executor/references/protocols/DOCUMENTATION-BOOTSTRAP.md +36 -36
  69. package/ftm-executor/references/protocols/MODEL-PROFILE.md +59 -44
  70. package/ftm-executor/references/protocols/PROGRESS-TRACKING.md +66 -66
  71. package/ftm-executor/runtime/ftm-runtime.mjs +252 -252
  72. package/ftm-executor/runtime/package.json +8 -8
  73. package/ftm-executor.yml +2 -2
  74. package/ftm-git/SKILL.md +441 -441
  75. package/ftm-git/evals/evals.json +26 -26
  76. package/ftm-git/evals/promptfoo.yaml +75 -75
  77. package/ftm-git/hooks/post-commit-experience.sh +92 -92
  78. package/ftm-git/references/patterns/SECRET-PATTERNS.md +104 -104
  79. package/ftm-git/references/protocols/REMEDIATION.md +139 -139
  80. package/ftm-git/scripts/pre-commit-secrets.sh +110 -110
  81. package/ftm-git.yml +2 -2
  82. package/ftm-inbox/backend/adapters/_retry.py +64 -64
  83. package/ftm-inbox/backend/adapters/base.py +230 -230
  84. package/ftm-inbox/backend/adapters/freshservice.py +104 -104
  85. package/ftm-inbox/backend/adapters/gmail.py +125 -125
  86. package/ftm-inbox/backend/adapters/jira.py +136 -136
  87. package/ftm-inbox/backend/adapters/registry.py +192 -192
  88. package/ftm-inbox/backend/adapters/slack.py +110 -110
  89. package/ftm-inbox/backend/db/connection.py +54 -54
  90. package/ftm-inbox/backend/db/schema.py +78 -78
  91. package/ftm-inbox/backend/executor/__init__.py +7 -7
  92. package/ftm-inbox/backend/executor/engine.py +149 -149
  93. package/ftm-inbox/backend/executor/step_runner.py +98 -98
  94. package/ftm-inbox/backend/main.py +103 -103
  95. package/ftm-inbox/backend/models/__init__.py +1 -1
  96. package/ftm-inbox/backend/models/unified_task.py +36 -36
  97. package/ftm-inbox/backend/planner/__init__.py +6 -6
  98. package/ftm-inbox/backend/planner/generator.py +127 -127
  99. package/ftm-inbox/backend/planner/schema.py +34 -34
  100. package/ftm-inbox/backend/requirements.txt +5 -5
  101. package/ftm-inbox/backend/routes/execute.py +186 -186
  102. package/ftm-inbox/backend/routes/health.py +52 -52
  103. package/ftm-inbox/backend/routes/inbox.py +68 -68
  104. package/ftm-inbox/backend/routes/plan.py +271 -271
  105. package/ftm-inbox/bin/launchagent.mjs +91 -91
  106. package/ftm-inbox/bin/setup.mjs +188 -188
  107. package/ftm-inbox/bin/start.sh +10 -10
  108. package/ftm-inbox/bin/status.sh +17 -17
  109. package/ftm-inbox/bin/stop.sh +8 -8
  110. package/ftm-inbox/config.example.yml +55 -55
  111. package/ftm-inbox/package-lock.json +2898 -2898
  112. package/ftm-inbox/package.json +26 -26
  113. package/ftm-inbox/postcss.config.js +6 -6
  114. package/ftm-inbox/src/app.css +199 -199
  115. package/ftm-inbox/src/app.html +18 -18
  116. package/ftm-inbox/src/lib/api.ts +166 -166
  117. package/ftm-inbox/src/lib/components/ExecutionLog.svelte +81 -81
  118. package/ftm-inbox/src/lib/components/InboxFeed.svelte +143 -143
  119. package/ftm-inbox/src/lib/components/PlanStep.svelte +271 -271
  120. package/ftm-inbox/src/lib/components/PlanView.svelte +206 -206
  121. package/ftm-inbox/src/lib/components/StreamPanel.svelte +99 -99
  122. package/ftm-inbox/src/lib/components/TaskCard.svelte +190 -190
  123. package/ftm-inbox/src/lib/components/ui/EmptyState.svelte +63 -63
  124. package/ftm-inbox/src/lib/components/ui/KawaiiCard.svelte +86 -86
  125. package/ftm-inbox/src/lib/components/ui/PillButton.svelte +106 -106
  126. package/ftm-inbox/src/lib/components/ui/StatusBadge.svelte +67 -67
  127. package/ftm-inbox/src/lib/components/ui/StreamDrawer.svelte +149 -149
  128. package/ftm-inbox/src/lib/components/ui/ThemeToggle.svelte +80 -80
  129. package/ftm-inbox/src/lib/theme.ts +47 -47
  130. package/ftm-inbox/src/routes/+layout.svelte +76 -76
  131. package/ftm-inbox/src/routes/+page.svelte +401 -401
  132. package/ftm-inbox/svelte.config.js +12 -12
  133. package/ftm-inbox/tailwind.config.ts +63 -63
  134. package/ftm-inbox/tsconfig.json +13 -13
  135. package/ftm-inbox/vite.config.ts +6 -6
  136. package/ftm-intent/SKILL.md +241 -241
  137. package/ftm-intent.yml +2 -2
  138. package/ftm-manifest.json +3794 -3794
  139. package/ftm-map/SKILL.md +291 -291
  140. package/ftm-map/scripts/db.py +712 -712
  141. package/ftm-map/scripts/index.py +415 -415
  142. package/ftm-map/scripts/parser.py +224 -224
  143. package/ftm-map/scripts/queries/go-tags.scm +20 -20
  144. package/ftm-map/scripts/queries/javascript-tags.scm +35 -35
  145. package/ftm-map/scripts/queries/python-tags.scm +31 -31
  146. package/ftm-map/scripts/queries/ruby-tags.scm +19 -19
  147. package/ftm-map/scripts/queries/rust-tags.scm +37 -37
  148. package/ftm-map/scripts/queries/typescript-tags.scm +41 -41
  149. package/ftm-map/scripts/query.py +301 -301
  150. package/ftm-map/scripts/ranker.py +377 -377
  151. package/ftm-map/scripts/requirements.txt +5 -5
  152. package/ftm-map/scripts/setup-hooks.sh +27 -27
  153. package/ftm-map/scripts/setup.sh +56 -56
  154. package/ftm-map/scripts/test_db.py +364 -364
  155. package/ftm-map/scripts/test_parser.py +174 -174
  156. package/ftm-map/scripts/test_query.py +183 -183
  157. package/ftm-map/scripts/test_ranker.py +199 -199
  158. package/ftm-map/scripts/views.py +591 -591
  159. package/ftm-map.yml +2 -2
  160. package/ftm-mind/SKILL.md +1943 -1943
  161. package/ftm-mind/evals/promptfoo.yaml +142 -142
  162. package/ftm-mind/references/blackboard-schema.md +328 -328
  163. package/ftm-mind/references/complexity-guide.md +110 -110
  164. package/ftm-mind/references/event-registry.md +319 -319
  165. package/ftm-mind/references/mcp-inventory.md +296 -296
  166. package/ftm-mind/references/protocols/COMPLEXITY-SIZING.md +72 -72
  167. package/ftm-mind/references/protocols/MCP-HEURISTICS.md +32 -32
  168. package/ftm-mind/references/protocols/PLAN-APPROVAL.md +80 -80
  169. package/ftm-mind/references/reflexion-protocol.md +249 -249
  170. package/ftm-mind/references/routing/SCENARIOS.md +22 -22
  171. package/ftm-mind/references/routing-scenarios.md +35 -35
  172. package/ftm-mind.yml +2 -2
  173. package/ftm-pause/SKILL.md +395 -395
  174. package/ftm-pause/references/protocols/SKILL-RESTORE-PROTOCOLS.md +186 -186
  175. package/ftm-pause/references/protocols/VALIDATION.md +80 -80
  176. package/ftm-pause.yml +2 -2
  177. package/ftm-researcher/SKILL.md +275 -275
  178. package/ftm-researcher/evals/agent-diversity.yaml +17 -17
  179. package/ftm-researcher/evals/synthesis-quality.yaml +12 -12
  180. package/ftm-researcher/evals/trigger-accuracy.yaml +39 -39
  181. package/ftm-researcher/references/adaptive-search.md +116 -116
  182. package/ftm-researcher/references/agent-prompts.md +193 -193
  183. package/ftm-researcher/references/council-integration.md +193 -193
  184. package/ftm-researcher/references/output-format.md +203 -203
  185. package/ftm-researcher/references/synthesis-pipeline.md +165 -165
  186. package/ftm-researcher/scripts/score_credibility.py +234 -234
  187. package/ftm-researcher/scripts/validate_research.py +92 -92
  188. package/ftm-researcher.yml +2 -2
  189. package/ftm-resume/SKILL.md +518 -518
  190. package/ftm-resume/references/protocols/VALIDATION.md +172 -172
  191. package/ftm-resume.yml +2 -2
  192. package/ftm-retro/SKILL.md +380 -380
  193. package/ftm-retro/references/protocols/SCORING-RUBRICS.md +89 -89
  194. package/ftm-retro/references/templates/REPORT-FORMAT.md +109 -109
  195. package/ftm-retro.yml +2 -2
  196. package/ftm-routine/SKILL.md +170 -170
  197. package/ftm-routine.yml +4 -4
  198. package/ftm-state/blackboard/capabilities.json +5 -5
  199. package/ftm-state/blackboard/capabilities.schema.json +27 -27
  200. package/ftm-state/blackboard/context.json +23 -23
  201. package/ftm-state/blackboard/experiences/index.json +9 -9
  202. package/ftm-state/blackboard/patterns.json +6 -6
  203. package/ftm-state/schemas/context.schema.json +130 -130
  204. package/ftm-state/schemas/experience-index.schema.json +77 -77
  205. package/ftm-state/schemas/experience.schema.json +78 -78
  206. package/ftm-state/schemas/patterns.schema.json +44 -44
  207. package/ftm-upgrade/SKILL.md +194 -194
  208. package/ftm-upgrade/scripts/check-version.sh +76 -76
  209. package/ftm-upgrade/scripts/upgrade.sh +143 -143
  210. package/ftm-upgrade.yml +2 -2
  211. package/ftm-verify.yml +2 -2
  212. package/ftm.yml +2 -2
  213. package/hooks/ftm-blackboard-enforcer.sh +93 -93
  214. package/hooks/ftm-discovery-reminder.sh +90 -90
  215. package/hooks/ftm-drafts-gate.sh +61 -61
  216. package/hooks/ftm-event-logger.mjs +107 -107
  217. package/hooks/ftm-map-autodetect.sh +79 -79
  218. package/hooks/ftm-pending-sync-check.sh +22 -22
  219. package/hooks/ftm-plan-gate.sh +92 -92
  220. package/hooks/ftm-post-commit-trigger.sh +57 -57
  221. package/hooks/settings-template.json +81 -81
  222. package/install.sh +363 -363
  223. package/package.json +84 -84
  224. package/uninstall.sh +25 -25
@@ -1,174 +1,174 @@
1
- """Tests for parser.py -- Aider-style def/ref tag extraction."""
2
- import os
3
- import sys
4
- import pytest
5
-
6
- sys.path.insert(0, os.path.dirname(__file__))
7
- from parser import get_tags, detect_language, Tag, EXTENSION_MAP
8
-
9
- FIXTURES = os.path.join(os.path.dirname(__file__), "tests", "fixtures", "sample_project")
10
-
11
-
12
- class TestDetectLanguage:
13
- def test_python(self):
14
- assert detect_language("foo.py") == "python"
15
-
16
- def test_typescript(self):
17
- assert detect_language("foo.ts") == "typescript"
18
-
19
- def test_javascript(self):
20
- assert detect_language("foo.js") == "javascript"
21
-
22
- def test_tsx(self):
23
- assert detect_language("foo.tsx") == "tsx"
24
-
25
- def test_unknown(self):
26
- assert detect_language("foo.txt") is None
27
-
28
- def test_all_extensions_mapped(self):
29
- for ext, lang in EXTENSION_MAP.items():
30
- assert lang is not None, f"Extension {ext} mapped to None"
31
-
32
-
33
- class TestPythonTags:
34
- def test_extracts_defs_and_refs(self):
35
- fpath = os.path.join(FIXTURES, "auth.py")
36
- tags = get_tags(fpath, "auth.py")
37
- defs = [t for t in tags if t.kind == "def"]
38
- refs = [t for t in tags if t.kind == "ref"]
39
- assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
40
- assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
41
-
42
- def test_def_names_correct(self):
43
- fpath = os.path.join(FIXTURES, "auth.py")
44
- tags = get_tags(fpath, "auth.py")
45
- def_names = {t.name for t in tags if t.kind == "def"}
46
- assert "handleAuth" in def_names
47
- assert "validateToken" in def_names
48
- assert "getUser" in def_names
49
-
50
- def test_ref_names_correct(self):
51
- fpath = os.path.join(FIXTURES, "auth.py")
52
- tags = get_tags(fpath, "auth.py")
53
- ref_names = {t.name for t in tags if t.kind == "ref"}
54
- assert "validateToken" in ref_names
55
- assert "getUser" in ref_names
56
-
57
- def test_no_garbled_names(self):
58
- fpath = os.path.join(FIXTURES, "auth.py")
59
- tags = get_tags(fpath, "auth.py")
60
- for tag in tags:
61
- assert tag.name.isidentifier(), f"Garbled name: {tag.name}"
62
-
63
- def test_tag_has_correct_fields(self):
64
- fpath = os.path.join(FIXTURES, "auth.py")
65
- tags = get_tags(fpath, "auth.py")
66
- assert len(tags) > 0
67
- tag = tags[0]
68
- assert hasattr(tag, "rel_fname")
69
- assert hasattr(tag, "fname")
70
- assert hasattr(tag, "line")
71
- assert hasattr(tag, "name")
72
- assert hasattr(tag, "kind")
73
- assert tag.kind in ("def", "ref")
74
-
75
- def test_rel_fname_propagated(self):
76
- fpath = os.path.join(FIXTURES, "auth.py")
77
- tags = get_tags(fpath, "auth.py")
78
- for tag in tags:
79
- assert tag.rel_fname == "auth.py"
80
-
81
- def test_no_duplicates(self):
82
- fpath = os.path.join(FIXTURES, "auth.py")
83
- tags = get_tags(fpath, "auth.py")
84
- seen = set()
85
- for tag in tags:
86
- key = (tag.name, tag.line, tag.kind)
87
- assert key not in seen, f"Duplicate tag: {tag}"
88
- seen.add(key)
89
-
90
-
91
- class TestTypeScriptTags:
92
- def test_extracts_defs_and_refs(self):
93
- fpath = os.path.join(FIXTURES, "api.ts")
94
- tags = get_tags(fpath, "api.ts")
95
- defs = [t for t in tags if t.kind == "def"]
96
- refs = [t for t in tags if t.kind == "ref"]
97
- assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
98
- assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
99
-
100
- def test_captures_class(self):
101
- fpath = os.path.join(FIXTURES, "api.ts")
102
- tags = get_tags(fpath, "api.ts")
103
- def_names = {t.name for t in tags if t.kind == "def"}
104
- assert "ApiController" in def_names
105
-
106
- def test_captures_function_defs(self):
107
- fpath = os.path.join(FIXTURES, "api.ts")
108
- tags = get_tags(fpath, "api.ts")
109
- def_names = {t.name for t in tags if t.kind == "def"}
110
- assert "processRequest" in def_names
111
- assert "formatResponse" in def_names
112
-
113
- def test_captures_call_refs(self):
114
- fpath = os.path.join(FIXTURES, "api.ts")
115
- tags = get_tags(fpath, "api.ts")
116
- ref_names = {t.name for t in tags if t.kind == "ref"}
117
- assert "handleAuth" in ref_names or "formatResponse" in ref_names
118
-
119
- def test_captures_cross_file_ref(self):
120
- """api.ts imports and calls handleAuth from auth.py -- should appear as ref."""
121
- fpath = os.path.join(FIXTURES, "api.ts")
122
- tags = get_tags(fpath, "api.ts")
123
- ref_names = {t.name for t in tags if t.kind == "ref"}
124
- assert "handleAuth" in ref_names
125
-
126
-
127
- class TestJavaScriptTags:
128
- def test_extracts_defs_and_refs(self):
129
- fpath = os.path.join(FIXTURES, "utils.js")
130
- tags = get_tags(fpath, "utils.js")
131
- defs = [t for t in tags if t.kind == "def"]
132
- refs = [t for t in tags if t.kind == "ref"]
133
- assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
134
- assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
135
-
136
- def test_arrow_function_defs(self):
137
- fpath = os.path.join(FIXTURES, "utils.js")
138
- tags = get_tags(fpath, "utils.js")
139
- def_names = {t.name for t in tags if t.kind == "def"}
140
- assert "processData" in def_names
141
-
142
- def test_regular_function_defs(self):
143
- fpath = os.path.join(FIXTURES, "utils.js")
144
- tags = get_tags(fpath, "utils.js")
145
- def_names = {t.name for t in tags if t.kind == "def"}
146
- assert "formatDate" in def_names
147
- assert "parseConfig" in def_names
148
-
149
- def test_cross_function_refs(self):
150
- fpath = os.path.join(FIXTURES, "utils.js")
151
- tags = get_tags(fpath, "utils.js")
152
- ref_names = {t.name for t in tags if t.kind == "ref"}
153
- assert "parseConfig" in ref_names
154
- assert "formatDate" in ref_names
155
-
156
-
157
- class TestNonexistentFile:
158
- def test_returns_empty(self):
159
- tags = get_tags("/nonexistent/file.py", "file.py")
160
- assert tags == []
161
-
162
- def test_unknown_extension(self):
163
- tags = get_tags("file.xyz", "file.xyz")
164
- assert tags == []
165
-
166
-
167
- class TestTagNamedTuple:
168
- def test_tag_is_namedtuple(self):
169
- tag = Tag(rel_fname="a.py", fname="/a.py", line=1, name="foo", kind="def")
170
- assert tag.rel_fname == "a.py"
171
- assert tag.fname == "/a.py"
172
- assert tag.line == 1
173
- assert tag.name == "foo"
174
- assert tag.kind == "def"
1
+ """Tests for parser.py -- Aider-style def/ref tag extraction."""
2
+ import os
3
+ import sys
4
+ import pytest
5
+
6
+ sys.path.insert(0, os.path.dirname(__file__))
7
+ from parser import get_tags, detect_language, Tag, EXTENSION_MAP
8
+
9
+ FIXTURES = os.path.join(os.path.dirname(__file__), "tests", "fixtures", "sample_project")
10
+
11
+
12
+ class TestDetectLanguage:
13
+ def test_python(self):
14
+ assert detect_language("foo.py") == "python"
15
+
16
+ def test_typescript(self):
17
+ assert detect_language("foo.ts") == "typescript"
18
+
19
+ def test_javascript(self):
20
+ assert detect_language("foo.js") == "javascript"
21
+
22
+ def test_tsx(self):
23
+ assert detect_language("foo.tsx") == "tsx"
24
+
25
+ def test_unknown(self):
26
+ assert detect_language("foo.txt") is None
27
+
28
+ def test_all_extensions_mapped(self):
29
+ for ext, lang in EXTENSION_MAP.items():
30
+ assert lang is not None, f"Extension {ext} mapped to None"
31
+
32
+
33
+ class TestPythonTags:
34
+ def test_extracts_defs_and_refs(self):
35
+ fpath = os.path.join(FIXTURES, "auth.py")
36
+ tags = get_tags(fpath, "auth.py")
37
+ defs = [t for t in tags if t.kind == "def"]
38
+ refs = [t for t in tags if t.kind == "ref"]
39
+ assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
40
+ assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
41
+
42
+ def test_def_names_correct(self):
43
+ fpath = os.path.join(FIXTURES, "auth.py")
44
+ tags = get_tags(fpath, "auth.py")
45
+ def_names = {t.name for t in tags if t.kind == "def"}
46
+ assert "handleAuth" in def_names
47
+ assert "validateToken" in def_names
48
+ assert "getUser" in def_names
49
+
50
+ def test_ref_names_correct(self):
51
+ fpath = os.path.join(FIXTURES, "auth.py")
52
+ tags = get_tags(fpath, "auth.py")
53
+ ref_names = {t.name for t in tags if t.kind == "ref"}
54
+ assert "validateToken" in ref_names
55
+ assert "getUser" in ref_names
56
+
57
+ def test_no_garbled_names(self):
58
+ fpath = os.path.join(FIXTURES, "auth.py")
59
+ tags = get_tags(fpath, "auth.py")
60
+ for tag in tags:
61
+ assert tag.name.isidentifier(), f"Garbled name: {tag.name}"
62
+
63
+ def test_tag_has_correct_fields(self):
64
+ fpath = os.path.join(FIXTURES, "auth.py")
65
+ tags = get_tags(fpath, "auth.py")
66
+ assert len(tags) > 0
67
+ tag = tags[0]
68
+ assert hasattr(tag, "rel_fname")
69
+ assert hasattr(tag, "fname")
70
+ assert hasattr(tag, "line")
71
+ assert hasattr(tag, "name")
72
+ assert hasattr(tag, "kind")
73
+ assert tag.kind in ("def", "ref")
74
+
75
+ def test_rel_fname_propagated(self):
76
+ fpath = os.path.join(FIXTURES, "auth.py")
77
+ tags = get_tags(fpath, "auth.py")
78
+ for tag in tags:
79
+ assert tag.rel_fname == "auth.py"
80
+
81
+ def test_no_duplicates(self):
82
+ fpath = os.path.join(FIXTURES, "auth.py")
83
+ tags = get_tags(fpath, "auth.py")
84
+ seen = set()
85
+ for tag in tags:
86
+ key = (tag.name, tag.line, tag.kind)
87
+ assert key not in seen, f"Duplicate tag: {tag}"
88
+ seen.add(key)
89
+
90
+
91
+ class TestTypeScriptTags:
92
+ def test_extracts_defs_and_refs(self):
93
+ fpath = os.path.join(FIXTURES, "api.ts")
94
+ tags = get_tags(fpath, "api.ts")
95
+ defs = [t for t in tags if t.kind == "def"]
96
+ refs = [t for t in tags if t.kind == "ref"]
97
+ assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
98
+ assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
99
+
100
+ def test_captures_class(self):
101
+ fpath = os.path.join(FIXTURES, "api.ts")
102
+ tags = get_tags(fpath, "api.ts")
103
+ def_names = {t.name for t in tags if t.kind == "def"}
104
+ assert "ApiController" in def_names
105
+
106
+ def test_captures_function_defs(self):
107
+ fpath = os.path.join(FIXTURES, "api.ts")
108
+ tags = get_tags(fpath, "api.ts")
109
+ def_names = {t.name for t in tags if t.kind == "def"}
110
+ assert "processRequest" in def_names
111
+ assert "formatResponse" in def_names
112
+
113
+ def test_captures_call_refs(self):
114
+ fpath = os.path.join(FIXTURES, "api.ts")
115
+ tags = get_tags(fpath, "api.ts")
116
+ ref_names = {t.name for t in tags if t.kind == "ref"}
117
+ assert "handleAuth" in ref_names or "formatResponse" in ref_names
118
+
119
+ def test_captures_cross_file_ref(self):
120
+ """api.ts imports and calls handleAuth from auth.py -- should appear as ref."""
121
+ fpath = os.path.join(FIXTURES, "api.ts")
122
+ tags = get_tags(fpath, "api.ts")
123
+ ref_names = {t.name for t in tags if t.kind == "ref"}
124
+ assert "handleAuth" in ref_names
125
+
126
+
127
+ class TestJavaScriptTags:
128
+ def test_extracts_defs_and_refs(self):
129
+ fpath = os.path.join(FIXTURES, "utils.js")
130
+ tags = get_tags(fpath, "utils.js")
131
+ defs = [t for t in tags if t.kind == "def"]
132
+ refs = [t for t in tags if t.kind == "ref"]
133
+ assert len(defs) >= 3, f"Expected >=3 defs, got {len(defs)}: {[t.name for t in defs]}"
134
+ assert len(refs) >= 2, f"Expected >=2 refs, got {len(refs)}: {[t.name for t in refs]}"
135
+
136
+ def test_arrow_function_defs(self):
137
+ fpath = os.path.join(FIXTURES, "utils.js")
138
+ tags = get_tags(fpath, "utils.js")
139
+ def_names = {t.name for t in tags if t.kind == "def"}
140
+ assert "processData" in def_names
141
+
142
+ def test_regular_function_defs(self):
143
+ fpath = os.path.join(FIXTURES, "utils.js")
144
+ tags = get_tags(fpath, "utils.js")
145
+ def_names = {t.name for t in tags if t.kind == "def"}
146
+ assert "formatDate" in def_names
147
+ assert "parseConfig" in def_names
148
+
149
+ def test_cross_function_refs(self):
150
+ fpath = os.path.join(FIXTURES, "utils.js")
151
+ tags = get_tags(fpath, "utils.js")
152
+ ref_names = {t.name for t in tags if t.kind == "ref"}
153
+ assert "parseConfig" in ref_names
154
+ assert "formatDate" in ref_names
155
+
156
+
157
+ class TestNonexistentFile:
158
+ def test_returns_empty(self):
159
+ tags = get_tags("/nonexistent/file.py", "file.py")
160
+ assert tags == []
161
+
162
+ def test_unknown_extension(self):
163
+ tags = get_tags("file.xyz", "file.xyz")
164
+ assert tags == []
165
+
166
+
167
+ class TestTagNamedTuple:
168
+ def test_tag_is_namedtuple(self):
169
+ tag = Tag(rel_fname="a.py", fname="/a.py", line=1, name="foo", kind="def")
170
+ assert tag.rel_fname == "a.py"
171
+ assert tag.fname == "/a.py"
172
+ assert tag.line == 1
173
+ assert tag.name == "foo"
174
+ assert tag.kind == "def"