@jitera/connect 1.5.0 → 2.1.0

package/dist/statusline.d.ts

@@ -2,6 +2,7 @@ import type { SessionStatus } from "./session-status.ts";
 export interface StatusLineInput {
     readonly status?: SessionStatus | undefined;
     readonly markerEnvironment?: string | undefined;
+    readonly bound?: boolean | undefined;
 }
-export declare function renderStatusLine({ status, markerEnvironment }: StatusLineInput): string;
+export declare function renderStatusLine({ status, markerEnvironment, bound, }: StatusLineInput): string;
 //# sourceMappingURL=statusline.d.ts.map

package/dist/statusline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,eAAe,GAAG,MAAM,CAmBvF"}
+{"version":3,"file":"statusline.d.ts","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAGhD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAUD,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,iBAAiB,EACjB,KAAK,GACN,EAAE,eAAe,GAAG,MAAM,CAwB1B"}

package/dist/statusline.js

@@ -8,11 +8,16 @@ function compactChars(chars) {
 function compactMs(ms) {
     return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${ms}ms`;
 }
-export function renderStatusLine({ status, markerEnvironment }) {
+export function renderStatusLine({ status, markerEnvironment, bound, }) {
     if (!status)
         return `${DIM}○${RESET} jitera`;
     if (!status.configured)
         return `${DIM}○${RESET} jitera · not connected`;
+    // Connected, but this repository is not bound to a project, so the hooks
+    // deliberately do nothing here. Carry the command that fixes it.
+    if (bound === false) {
+        return `${YELLOW}○${RESET} jitera · not initialised · npx @jitera/connect init`;
+    }
     const dot = status.recallError ? `${YELLOW}●${RESET}` : `${GREEN}●${RESET}`;
     const parts = [`${dot} jitera`];
     if (status.environment)

package/dist/statusline.js.map

@@ -1 +1 @@
-{"version":3,"file":"statusline.js","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,OAAO,CAAC;AACtB,MAAM,MAAM,GAAG,OAAO,CAAC;AACvB,MAAM,GAAG,GAAG,MAAM,CAAC;AACnB,MAAM,KAAK,GAAG,MAAM,CAAC;AAOrB,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAmB;IAC7E,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,GAAG,IAAI,KAAK,SAAS,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,GAAG,GAAG,IAAI,KAAK,yBAAyB,CAAC;IAExE,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,WAAW,IAAI,iBAAiB,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,cAAc,iBAAiB,GAAG,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"statusline.js","sourceRoot":"","sources":["../src/statusline.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,OAAO,CAAC;AACtB,MAAM,MAAM,GAAG,OAAO,CAAC;AACvB,MAAM,GAAG,GAAG,MAAM,CAAC;AACnB,MAAM,KAAK,GAAG,MAAM,CAAC;AAUrB,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAC/B,MAAM,EACN,iBAAiB,EACjB,KAAK,GACW;IAChB,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,GAAG,IAAI,KAAK,SAAS,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,GAAG,GAAG,IAAI,KAAK,yBAAyB,CAAC;IACxE,yEAAyE;IACzE,iEAAiE;IACjE,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,GAAG,MAAM,IAAI,KAAK,sDAAsD,CAAC;IAClF,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9B,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,UAAU,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAAC,WAAW,IAAI,iBAAiB,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QACxF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,cAAc,iBAAiB,GAAG,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jitera/connect",
-  "version": "1.5.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Connect AI coding assistants to Jitera projects: documentation, source, and shared project memory",
   "license": "Apache-2.0",

package/skills/jitera-context/SKILL.md

@@ -17,6 +17,24 @@ Three virtual domains:
 | `sources/` | Project source code | no |
 | `uploads/` | Uploaded files | no |
 
+## Start with the whole picture
+
+```
+gather_jitera_context(task="how do refunds get issued", budget=6000)
+```
+
+Recalls project memory and searches documentation and source in one call,
+running the widening fallbacks itself: memory falls back to every stored entity
+when keywords match nothing, and search falls back to fuzzy matching when exact
+matching is dry. It also lists the project's agents, so a recalled fact can be
+attributed. Use it before planning or answering, then narrow with the tools
+below.
+
+It is not a once-per-session lookup. Call it again whenever the work reaches
+something you have not gathered context for yet: a subsystem you have not
+touched, a name you do not recognise, or a decision about how something should
+work. Checking costs one call; guessing costs the rest of the session.
+
 ## Searching
 
 ```
@@ -27,6 +45,10 @@ resource_search(pattern="documents/**/*.md", content="refund", limit=30, offset=
   domain prefix to search every domain: `resource_search(pattern="**/checkout*.*")`
 - `content` — a grep-style match inside files, supporting boolean expressions:
   `content="(api OR rest) AND controller"`
+- `mode` — how `content` is matched. `default` is a case-insensitive substring;
+  `regex` treats `content` as a case-insensitive regular expression; `full-text`
+  matches fuzzily by trigram similarity, for when you are unsure of the exact
+  wording. `pattern` is always a glob, whatever the mode
 - Results are grouped by domain. Open a match with `resource_read`
 
 Search before reading. Do not guess paths.

package/skills/jitera-memory/SKILL.md

@@ -31,17 +31,35 @@ failed.
 
 ### When the first recall comes back thin
 
-`recall_jitera_memory` filters entities by keywords extracted from `query`. Work
-down this ladder, stopping as soon as you have what you need:
+`gather_jitera_context` runs this ladder for you and says when it widened, so
+prefer it for a first look. Reach for `recall_jitera_memory` directly when you
+want memory alone, and work down the ladder yourself:
 
 1. `recall_jitera_memory(query="<specific terms from the task>")`
 2. `recall_jitera_memory(query="<the subsystem or domain>")`
 3. `recall_jitera_memory()` with no query — returns every stored entity
 
+Keywords are combined with OR, so *more* terms match more entities. There is no
+narrower rung below step 1 — when it comes back empty, widen rather than
+refine.
+
 Do not conclude that memory is empty until step 3 returns nothing. Results
 containing `[[id]]` references mean related entities exist, and a broader query
 will surface them.
 
+### Whose memory you are reading
+
+Each agent in a project writes to its own partition. A project-level key reads
+across all of them, so a recalled fact may have been written by any agent;
+`list_jitera_agents` names them. A key pinned to one agent sees only that
+agent's own partition.
+
+A repository can narrow that itself: `.jitera.json` may carry an `agents` list,
+written by `npx @jitera/connect set-agent`, and sessions there read only those
+agents plus anything written project-wide. Pass `agents` to
+`recall_jitera_memory` or `gather_jitera_context` to narrow a single call the
+same way. Omit it to read every agent.
+
 ## Remember when knowledge is created
 
 Persist with `remember_jitera_memory(name, type, attrs)` when:

package/templates/AGENTS.md.tmpl

@@ -4,16 +4,22 @@
 This repository is connected to a {{BRAND}} project. Documentation, source, and a
 shared project memory are available through the `jitera` MCP server.
 
-Before planning or implementing anything, call `recall_jitera_memory`. An empty
-result is normal and is not an error.
+Before planning or implementing anything, and before answering a question about
+this project, call `gather_jitera_context` with the task in your own words. It
+recalls project memory and searches documentation and source in one pass. An
+empty result is normal and is not an error.
+
+Keep using it as the work moves. It is not a once-per-session lookup: call it
+again whenever you reach an area you have not gathered context for yet.
 
 Before writing a spec or design, search `documents/` with `resource_search` and
 read any match with `resource_read`. Update the existing document rather than
 creating a second one.
 
 When a decision is made, a constraint is discovered, or you are corrected,
-persist it with `remember_jitera_memory`. Recall the entity first and re-send its
-full attribute list, because entities are keyed on name plus type.
+persist it with `remember_jitera_memory`. Recall the entity first with
+`recall_jitera_memory` and re-send its full attribute list, because entities are
+keyed on name plus type.
 
 `documents/` is readable and writable. `sources/` and `uploads/` are read-only.