indexer-cli 0.12.15 → 0.12.16
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.
|
@@ -1,11 +1,8 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.GENERATED_SKILL_DIRECTORIES = exports.DEPRECATED_SKILL_DIRECTORIES = exports.GENERATED_SKILLS = void 0;
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
name: "repo-discovery",
|
|
7
|
-
directory: "repo-discovery",
|
|
8
|
-
content: `---
|
|
4
|
+
function buildRepoDiscoverySkillContent() {
|
|
5
|
+
return `---
|
|
9
6
|
name: repo-discovery
|
|
10
7
|
description: FIRST choice for repository discovery and code understanding. Use this to choose the cheapest indexed path for architecture, structure, behavior, symbol, AST, or dependency questions before broad file reads or blind text search.
|
|
11
8
|
allowed-tools: Bash(idx architecture:*), Bash(idx structure:*), Bash(idx ast:*), Bash(idx search:*), Bash(idx explain:*), Bash(idx deps:*), Bash(rg:*), Bash(grep:*)
|
|
@@ -21,7 +18,7 @@ Pick the single cheapest command that answers the question, run it, and stop whe
|
|
|
21
18
|
|
|
22
19
|
- \`idx architecture\` — repo shape, entry points, module boundaries, cycle causes, unresolved dependency classes
|
|
23
20
|
- \`idx structure\` — file trees, exported symbols with line ranges, contents of a directory/module
|
|
24
|
-
- \`idx ast <file>\` — compact syntax tree for one large file when
|
|
21
|
+
- \`idx ast <file>\` — compact syntax tree for one large file; use before repeated reads when ranges are coarse or JSX/parent structure matters
|
|
25
22
|
- \`idx search\` — conceptual behavior questions like "how does X work?"; returns ranked file ranges plus \`why=\` reason codes
|
|
26
23
|
- \`idx explain\` — a known symbol when you want indexed explanation
|
|
27
24
|
- \`idx deps\` — imported-by/imports or impact for a known path/module
|
|
@@ -33,7 +30,7 @@ Pick the single cheapest command that answers the question, run it, and stop whe
|
|
|
33
30
|
- Use \`--path-prefix\` whenever the subsystem is known, e.g. \`src/api/\`, \`src/auth/\`.
|
|
34
31
|
- For \`idx structure\`, also narrow with \`--kind\` when possible.
|
|
35
32
|
- If \`idx structure\` prints \`TRUNC\`/\`NEXT\`, run the \`NEXT\` command only when the hidden page is still relevant.
|
|
36
|
-
- Use \`idx ast <file>\`
|
|
33
|
+
- Use \`idx ast <file>\` after you know a large file is relevant and need a map before reading ranges; if you are about to make a second overlapping \`Read\` on that file, run \`idx ast\` first.
|
|
37
34
|
- If \`idx ast\` prints \`TRUNC\`/\`NEXT\`, run \`NEXT\` only when the hidden nodes are still relevant.
|
|
38
35
|
- For \`idx deps\`, start with \`--depth 1\`; increase only if first-hop impact is insufficient.
|
|
39
36
|
- For \`idx explain\`, prefer \`file::symbol\` when the name may be ambiguous.
|
|
@@ -50,7 +47,7 @@ idx is **semantic** search: use it when you do **not** know the exact name and n
|
|
|
50
47
|
Use exact text search/LSP when the target is already concrete:
|
|
51
48
|
- exact identifier name → \`rg\` (preferred), \`grep\`, \`lsp_symbols\`, or references/definition tools
|
|
52
49
|
- exact small file path → \`Read\`
|
|
53
|
-
- exact large file path + unknown internal layout → \`idx ast <file>\`, then read the smallest ranges
|
|
50
|
+
- exact large file path + unknown internal layout or nested JSX → \`idx ast <file>\`, then read the smallest ranges
|
|
54
51
|
- known file + known symbol → \`idx explain file::symbol\` or LSP if exact lookup is enough
|
|
55
52
|
|
|
56
53
|
Rule of thumb: avoid broad blind \`rg\`/\`grep\`/\`find\` during discovery, but if you can write an exact search pattern, use \`rg\`/LSP. Use idx for exploration, not lookup.
|
|
@@ -104,7 +101,7 @@ rg -n "MyType" src/models/
|
|
|
104
101
|
|
|
105
102
|
## Skip idx when
|
|
106
103
|
|
|
107
|
-
- you already know the exact file to read
|
|
104
|
+
- you already know the exact small file/range to read
|
|
108
105
|
- you need an exact identifier lookup
|
|
109
106
|
- you already know the file and want document-local symbols/usages
|
|
110
107
|
- you are done discovering and are now editing or validating code
|
|
@@ -117,7 +114,13 @@ rg -n "MyType" src/models/
|
|
|
117
114
|
- Search: \`idx search <query> [--max-files <n>] [--path-prefix <area>] [--chunk-types <types|api|impl|tests|imports>] [--mode hybrid|semantic|lexical|symbol] [--min-score <score>] [--include-content] [--include-imports] [--dedupe-file] [--dedupe-symbol] [--cluster] [--exclude-tests] [--include-tests]\`
|
|
118
115
|
- Explain: \`idx explain <symbol|file::symbol> [--path-prefix <area>] [--include-fixtures] [--include-body] [--body-lines <n>] [--signature-only]\`
|
|
119
116
|
- Deps: \`idx deps <path> [--direction callers|callees|both] [--depth <n>] [--show-edges] [--tests]\`
|
|
120
|
-
|
|
117
|
+
`;
|
|
118
|
+
}
|
|
119
|
+
exports.GENERATED_SKILLS = [
|
|
120
|
+
{
|
|
121
|
+
name: "repo-discovery",
|
|
122
|
+
directory: "repo-discovery",
|
|
123
|
+
content: buildRepoDiscoverySkillContent(),
|
|
121
124
|
},
|
|
122
125
|
];
|
|
123
126
|
exports.DEPRECATED_SKILL_DIRECTORIES = [
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":";;;AAMA,SAAS,8BAA8B;IACtC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgHP,CAAC;AACF,CAAC;AAEY,QAAA,gBAAgB,GAAqB;IACjD;QACC,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,8BAA8B,EAAE;KACzC;CACD,CAAC;AAEW,QAAA,4BAA4B,GAAG;IAC3C,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;CAClB,CAAC;AAEW,QAAA,2BAA2B,GAAG,wBAAgB,CAAC,GAAG,CAC9D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAC1B,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SKILLS_VERSION =
|
|
1
|
+
export declare const SKILLS_VERSION = 503726199;
|