@tablation/crew 0.117.0 → 0.117.1

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tablation/crew",
3
- "version": "0.117.0",
3
+ "version": "0.117.1",
4
4
  "description": "A standing team of headless agents that picks work off a Tablation board, does it on a machine you control, and reports back.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -93,6 +93,11 @@ available only in a repository whose hooks table declares `preview`.
93
93
  the URL. Tell them where it is once, early: the URL always, and, when you
94
94
  are the operator's own session on this ship (not a Passenger's chat), the
95
95
  worktree path as well, so they can open the files directly.
96
+ - **When the person refers to something on the page** ("this", "here",
97
+ "that heading"), read the newest line of `.crew/pointed-at.jsonl` in the
98
+ periscope's worktree before searching; it names the file and line they
99
+ clicked. If the file is empty, ask them to point at it with the inspector
100
+ or paste the location.
96
101
  - **When a dev lane is mid-flight on the same files** (visible from the
97
102
  roster and the board), say so, so the person knows a merge is coming.
98
103
  - **Before keep,** read back the ticket title and a one-paragraph summary of
@@ -424,6 +424,26 @@ before going further, and never change a ticket's `report_type` yourself.
424
424
  sets the ticket back to `in_progress` instead of passing it to QA. A ticket
425
425
  with no Acceptance section is unaffected.
426
426
 
427
+ ### Finding where something lives
428
+
429
+ Before you read or edit, locate the code once, in this order:
430
+
431
+ 1. **The map.** Read the "Repository map" section of this brief (when the
432
+ repository has one) and the repository's own instructions file, which may
433
+ also say where things live.
434
+ 2. **The symbol tools.** When the Environment section lists code tools, use
435
+ them for code questions before searching text: find a symbol by name, list
436
+ its references, read its definition, outline a file. Text search is for
437
+ strings that are not symbols.
438
+ 3. **One broad search.** To find a visible string, search for it once across
439
+ the whole relevant tree, excluding tests, and prefer registries over
440
+ components. A search that found only a test file is widened, not
441
+ narrowed.
442
+
443
+ Count the calls: if more than three searches have not found the location, say
444
+ so in your progress comment and ask for the map or the person's pointer
445
+ rather than continuing to search.
446
+
427
447
  ## Step 4 — you never merge, and you never deploy
428
448
 
429
449
  **Nothing you do touches the base branch.** The release phase takes every
@@ -93,6 +93,11 @@ available only in a repository whose hooks table declares `preview`.
93
93
  the URL. Tell them where it is once, early: the URL always, and, when you
94
94
  are the operator's own session on this ship (not a Passenger's chat), the
95
95
  worktree path as well, so they can open the files directly.
96
+ - **When the person refers to something on the page** ("this", "here",
97
+ "that heading"), read the newest line of `.crew/pointed-at.jsonl` in the
98
+ periscope's worktree before searching; it names the file and line they
99
+ clicked. If the file is empty, ask them to point at it with the inspector
100
+ or paste the location.
96
101
  - **When a dev lane is mid-flight on the same files** (visible from the
97
102
  roster and the board), say so, so the person knows a merge is coming.
98
103
  - **Before keep,** read back the ticket title and a one-paragraph summary of
@@ -419,6 +419,26 @@ before going further, and never change a ticket's `report_type` yourself.
419
419
  sets the ticket back to `in_progress` instead of passing it to QA. A ticket
420
420
  with no Acceptance section is unaffected.
421
421
 
422
+ ### Finding where something lives
423
+
424
+ Before you read or edit, locate the code once, in this order:
425
+
426
+ 1. **The map.** Read the "Repository map" section of this brief (when the
427
+ repository has one) and the repository's own instructions file, which may
428
+ also say where things live.
429
+ 2. **The symbol tools.** When the Environment section lists code tools, use
430
+ them for code questions before searching text: find a symbol by name, list
431
+ its references, read its definition, outline a file. Text search is for
432
+ strings that are not symbols.
433
+ 3. **One broad search.** To find a visible string, search for it once across
434
+ the whole relevant tree, excluding tests, and prefer registries over
435
+ components. A search that found only a test file is widened, not
436
+ narrowed.
437
+
438
+ Count the calls: if more than three searches have not found the location, say
439
+ so in your progress comment and ask for the map or the person's pointer
440
+ rather than continuing to search.
441
+
422
442
  ## Step 4 — you never merge, and you never deploy
423
443
 
424
444
  **Nothing you do touches the base branch.** The release phase takes every