@jitera/connect 1.4.0 → 2.0.0

package/dist/statusline.js

@@ -0,0 +1,36 @@
+const GREEN = "";
+const YELLOW = "";
+const DIM = "";
+const RESET = "";
+function compactChars(chars) {
+    return chars >= 1000 ? `${(chars / 1000).toFixed(1)}k` : `${chars}ch`;
+}
+function compactMs(ms) {
+    return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${ms}ms`;
+}
+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)
+        parts.push(status.environment);
+    if (status.recallError) {
+        parts.push("recall failed");
+    }
+    else if (typeof status.recallMs === "number" && typeof status.recallChars === "number") {
+        parts.push(`recall ${compactChars(status.recallChars)}/${compactMs(status.recallMs)}`);
+    }
+    if (markerEnvironment && status.environment && markerEnvironment !== status.environment) {
+        parts.push(`${YELLOW}repo wants ${markerEnvironment}${RESET}`);
+    }
+    return parts.join(" · ");
+}
+//# sourceMappingURL=statusline.js.map

package/dist/statusline.js.map

@@ -0,0 +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;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.4.0",
+  "version": "2.0.0",
   "type": "module",
   "description": "Connect AI coding assistants to Jitera projects: documentation, source, and shared project memory",
   "license": "Apache-2.0",
@@ -20,8 +20,8 @@
     "node": ">=20"
   },
   "bin": {
-    "connect": "./dist/bin/connect.js",
-    "jitera-connect": "./dist/bin/connect.js"
+    "connect": "dist/bin/connect.js",
+    "jitera-connect": "dist/bin/connect.js"
   },
   "files": [
     "dist/",

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,29 @@ 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.
+
 ## 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.