@jitera/connect 1.5.0 → 2.0.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jitera-connect",
-  "version": "1.5.0",
+  "version": "2.0.0",
   "description": "Connect this workspace to a Jitera project: read documentation and source, and keep project memory up to date.",
   "author": {
     "name": "Jitera"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jitera-connect",
-  "version": "1.5.0",
+  "version": "2.0.0",
   "description": "Connect this workspace to a Jitera project: read documentation and source, and keep project memory up to date.",
   "skills": "./skills/"
 }

package/README.md

@@ -60,19 +60,26 @@ CLAUDE.md above a repo leaks into every project underneath it.
 ## what applies where
 
 the api key is global: one per user, per machine, stored by `login --install`.
-every repo you open uses it, so init is optional and nothing breaks without it.
-
-`.jitera.json` configures nothing by itself. it declares what the repo expects,
-and sessions check the two against each other. a teammate who has not signed in
-yet gets the exact login command for the right environment. a teammate pointed
-at a different environment gets a warning instead of quietly reading the wrong
-project.
-
-with a user-level key it does one more thing: it picks the project. the proxy
-and the hooks read it and send it as an `X-Jitera-Project` header, so several
-repos on one machine can talk to different projects through a single key. older
-deployments bind the key itself to one project, and there the marker only makes
-a mismatch visible.
+it says who you are, not which project you are in.
+
+`.jitera.json` says which project. without it a repo is unbound, and the hooks
+do nothing at all there: no context is gathered, no checkpoint is asked for, and
+no call reaches the server. a repo you have not run `init` in is left alone,
+which is why init is per repo and login is per machine.
+
+an unbound session is not silent about it. session start tells the assistant the
+repo is unbound and to suggest `npx @jitera/connect init`, and the status line
+shows the same thing.
+
+sessions also check the marker against the plugin. a teammate who has not signed
+in yet gets the exact login command for the right environment. a teammate
+pointed at a different environment gets a warning instead of quietly reading the
+wrong project.
+
+the proxy and the hooks send the project it names as an `X-Jitera-Project`
+header, so several repos on one machine can talk to different projects through a
+single key. older deployments bind the key itself to one project; there the
+marker still decides whether the hooks run, and makes a mismatch visible.
 
 ## seeing your keys
 

package/content/instructions.md

@@ -3,16 +3,19 @@ memory, documentation, and source. Treat it as the source of truth for this
 project, not an optional lookup.
 
 Before answering a question about this project, and before planning or
-implementing anything, call `recall_jitera_memory` first. An empty result is
-normal and is not an error.
+implementing anything, call `gather_jitera_context` with the task in the user's
+own words. It recalls memory and searches documentation and source in one pass,
+across every agent in the project. An empty result is normal, not an error.
+Call it again whenever the work reaches something you have not gathered context
+for; it is not a once-per-session lookup.
 
 Before writing a spec, design, or plan, 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 the user corrects you,
-persist it with `remember_jitera_memory`. Recall the entity first and re-send its
-full attribute list — entities are keyed on name plus type, so writing blind
+persist it with `remember_jitera_memory`. Recall the entity first with
+`recall_jitera_memory` and re-send its full attribute list — entities are keyed on name plus type, so writing blind
 creates duplicates and replaces facts instead of adding them.
 
 Do not store anything already recorded in the repository or its git history.

package/content/session-start-unbound.md

@@ -0,0 +1,12 @@
+An API key is configured, but this repository is not bound to a project.
+No project context is loaded and the MCP tools have nothing to read.
+Do not call them until this repository is bound.
+
+If the user asks about project context, documentation, or shared memory, or
+wants this repository bound to one, tell them to run this at the repository root:
+
+    npx @jitera/connect init
+
+That writes a .jitera.json recording which deployment and project this
+repository belongs to, alongside AGENTS.md and CLAUDE.md for the rest of the
+team. Once it exists, project context loads by itself at the start of a session.

package/content/session-start.md

@@ -2,10 +2,19 @@ Project context tools are configured for this workspace: project documentation,
 source, and a shared project memory over MCP.
 
 Before your first substantive answer in this session, and before planning or
-implementing anything, call `recall_jitera_memory`. An empty result is normal
-and is not an error. If the tools are missing from your tool list or a call
-fails, say so and continue without stored context instead of guessing.
+implementing anything, call `gather_jitera_context` with the task in the user's
+own words. An empty result is normal and is not an error.
+
+If the tools are missing from your tool list or a call fails, say so and
+continue without stored context instead of guessing.
+
+Keep using it as the work moves. This is not a once-per-session lookup: call it
+again whenever you reach an area you have not gathered context for yet, an
+unfamiliar name, or a decision about how something should work. Use
+`resource_search` and `resource_read` when you want one specific file rather
+than the whole picture.
 
 As decisions are made, constraints are discovered, or you are corrected, persist
-them with `remember_jitera_memory`. Recall the entity first and re-send its full
-attribute list, so you update it rather than creating a duplicate.
+them with `remember_jitera_memory`. Recall the entity first with
+`recall_jitera_memory` and re-send its full attribute list, so you update it
+rather than creating a duplicate.

package/dist/bin/statusline.js

@@ -13,5 +13,10 @@ catch {
 const dir = input.workspace?.project_dir ?? input.workspace?.current_dir ?? input.cwd;
 const marker = dir ? readProjectMarker(dir) : undefined;
 const status = readSessionStatus(input.session_id);
-process.stdout.write(`${renderStatusLine({ status, markerEnvironment: marker?.environment })}\n`);
+process.stdout.write(`${renderStatusLine({
+    status,
+    markerEnvironment: marker?.environment,
+    // No directory to inspect is not the same as an unbound repository.
+    bound: dir ? marker !== undefined : undefined,
+})}\n`);
 //# sourceMappingURL=statusline.js.map

package/dist/bin/statusline.js.map

@@ -1 +1 @@
-{"version":3,"file":"statusline.js","sourceRoot":"","sources":["../../src/bin/statusline.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQpD,IAAI,KAAK,GAAgB,EAAE,CAAC;AAC5B,IAAI,CAAC;IACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC;AAC7D,CAAC;AAAC,MAAM,CAAC;IACP,KAAK,GAAG,EAAE,CAAC;AACb,CAAC;AAED,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,GAAG,CAAC;AACtF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAEnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"statusline.js","sourceRoot":"","sources":["../../src/bin/statusline.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQpD,IAAI,KAAK,GAAgB,EAAE,CAAC;AAC5B,IAAI,CAAC;IACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAgB,CAAC;AAC7D,CAAC;AAAC,MAAM,CAAC;IACP,KAAK,GAAG,EAAE,CAAC;AACb,CAAC;AAED,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,SAAS,EAAE,WAAW,IAAI,KAAK,CAAC,GAAG,CAAC;AACtF,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAEnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,gBAAgB,CAAC;IAClB,MAAM;IACN,iBAAiB,EAAE,MAAM,EAAE,WAAW;IACtC,oEAAoE;IACpE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;CAC9C,CAAC,IAAI,CACP,CAAC"}

package/dist/hook-io.d.ts

@@ -9,6 +9,7 @@ export interface SessionStartInput extends HookInputBase {
     readonly source?: "startup" | "resume" | "clear" | "compact" | "fork";
 }
 export interface UserPromptSubmitInput extends HookInputBase {
+    readonly prompt?: string;
     readonly prompt_text?: string;
 }
 export interface StopInput extends HookInputBase {
@@ -18,5 +19,6 @@ export interface StopInput extends HookInputBase {
 }
 export type HookInput = SessionStartInput & UserPromptSubmitInput & StopInput;
 export declare function readHookInput(fd?: number): HookInput;
+export declare function promptText(input: UserPromptSubmitInput): string;
 export declare function emitContext(event: HookEventName, additionalContext: string): void;
 //# sourceMappingURL=hook-io.d.ts.map

package/dist/hook-io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-io.d.ts","sourceRoot":"","sources":["../src/hook-io.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,kBAAkB,GAClB,MAAM,GACN,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAE9E,wBAAgB,aAAa,CAAC,EAAE,GAAE,MAAU,GAAG,SAAS,CAMvD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAIjF"}
+{"version":3,"file":"hook-io.d.ts","sourceRoot":"","sources":["../src/hook-io.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,kBAAkB,GAClB,MAAM,GACN,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAI1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,MAAM,SAAS,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,SAAS,CAAC;AAE9E,wBAAgB,aAAa,CAAC,EAAE,GAAE,MAAU,GAAG,SAAS,CAMvD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAE/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAIjF"}

package/dist/hook-io.js

@@ -7,6 +7,9 @@ export function readHookInput(fd = 0) {
         return {};
     }
 }
+export function promptText(input) {
+    return (input.prompt ?? input.prompt_text ?? "").trim();
+}
 export function emitContext(event, additionalContext) {
     process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: event, additionalContext } }));
 }

package/dist/hook-io.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-io.js","sourceRoot":"","sources":["../src/hook-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAgCvC,MAAM,UAAU,aAAa,CAAC,EAAE,GAAW,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAc,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,iBAAyB;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,CACpF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"hook-io.js","sourceRoot":"","sources":["../src/hook-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAoCvC,MAAM,UAAU,aAAa,CAAC,EAAE,GAAW,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAc,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA4B;IACrD,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,iBAAyB;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,CACpF,CAAC;AACJ,CAAC"}

package/dist/hooks/session-start.js

@@ -12,7 +12,16 @@ const input = readHookInput();
 // teach the model to call tools that are not there.
 const apiKey = (process.env["CLAUDE_PLUGIN_OPTION_JITERA_API_KEY"] ?? "").trim();
 const configuredEnvironment = (process.env["CLAUDE_PLUGIN_OPTION_ENVIRONMENT"] ?? "").trim();
-const file = apiKey ? "session-start.md" : "session-start-unconfigured.md";
+// A committed .jitera.json binds the repository to a deployment and project.
+// Read it first: which directive applies depends on whether this repo is bound.
+const marker = readProjectMarker(input.cwd ?? process.cwd());
+// Three states, because "connected" and "bound to a project" are different
+// things: without a binding the tools would have no project to read.
+const file = !apiKey
+    ? "session-start-unconfigured.md"
+    : marker
+        ? "session-start.md"
+        : "session-start-unbound.md";
 let directive;
 try {
     directive = readFileSync(join(CONTENT_ROOT, file), "utf8").trim();
@@ -20,10 +29,6 @@ try {
 catch {
     process.exit(0);
 }
-// A committed .jitera.json binds the repository to a deployment, so teammates
-// who have not connected yet get the exact command, and a mismatched plugin
-// configuration is called out instead of silently reading the wrong project.
-const marker = readProjectMarker(input.cwd ?? process.cwd());
 writeSessionStatus(input.session_id, {
     configured: Boolean(apiKey),
     environment: configuredEnvironment || "studio",
@@ -42,5 +47,14 @@ if (marker?.environment) {
                 `Project context may come from the wrong deployment. Suggest rebinding with:\n\n    ${login}`;
     }
 }
+// `init` writes a marker with no project when nobody was signed in to pick one.
+// A project-scoped key still works, but a user-level key cannot infer a project
+// and every call quietly fails, so name the gap rather than let it dead-end.
+if (apiKey && marker && !marker.project) {
+    directive +=
+        `\n\nNote: this repository's .jitera.json records no project. A user-level ` +
+            `API key cannot infer one, so project context may not load. Suggest finishing ` +
+            `the binding with:\n\n    npx @jitera/connect init --project=<uuid>`;
+}
 emitContext("SessionStart", directive);
 //# sourceMappingURL=session-start.js.map

package/dist/hooks/session-start.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAE1F,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;AAE9B,gFAAgF;AAChF,+EAA+E;AAC/E,oDAAoD;AACpD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,MAAM,qBAAqB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7F,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,+BAA+B,CAAC;AAE3E,IAAI,SAAiB,CAAC;AACtB,IAAI,CAAC;IACH,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAE7D,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE;IACnC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAqB,IAAI,QAAQ;CAC/C,CAAC,CAAC;AAEH,IAAI,MAAM,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,mCAAmC,MAAM,CAAC,WAAW,YAAY,CAAC;IAChF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS;YACP,8DAA8D;gBAC9D,iBAAiB,MAAM,CAAC,WAAW,8CAA8C,KAAK,EAAE,CAAC;IAC7F,CAAC;SAAM,IAAI,qBAAqB,IAAI,qBAAqB,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QACjF,SAAS;YACP,gEAAgE;gBAChE,IAAI,MAAM,CAAC,WAAW,wCAAwC,qBAAqB,KAAK;gBACxF,sFAAsF,KAAK,EAAE,CAAC;IAClG,CAAC;AACH,CAAC;AAED,WAAW,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"session-start.js","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAE1F,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;AAE9B,gFAAgF;AAChF,+EAA+E;AAC/E,oDAAoD;AACpD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,MAAM,qBAAqB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7F,6EAA6E;AAC7E,gFAAgF;AAChF,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAE7D,2EAA2E;AAC3E,qEAAqE;AACrE,MAAM,IAAI,GAAG,CAAC,MAAM;IAClB,CAAC,CAAC,+BAA+B;IACjC,CAAC,CAAC,MAAM;QACN,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,0BAA0B,CAAC;AAEjC,IAAI,SAAiB,CAAC;AACtB,IAAI,CAAC;IACH,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE;IACnC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,qBAAqB,IAAI,QAAQ;CAC/C,CAAC,CAAC;AAEH,IAAI,MAAM,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,mCAAmC,MAAM,CAAC,WAAW,YAAY,CAAC;IAChF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS;YACP,8DAA8D;gBAC9D,iBAAiB,MAAM,CAAC,WAAW,8CAA8C,KAAK,EAAE,CAAC;IAC7F,CAAC;SAAM,IAAI,qBAAqB,IAAI,qBAAqB,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;QACjF,SAAS;YACP,gEAAgE;gBAChE,IAAI,MAAM,CAAC,WAAW,wCAAwC,qBAAqB,KAAK;gBACxF,sFAAsF,KAAK,EAAE,CAAC;IAClG,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAC7E,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACxC,SAAS;QACP,4EAA4E;YAC5E,+EAA+E;YAC/E,oEAAoE,CAAC;AACzE,CAAC;AAED,WAAW,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC"}

package/dist/hooks/stop.js

@@ -3,13 +3,19 @@ import { readFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { emitContext, readHookInput } from "../hook-io.js";
+import { readProjectMarker } from "../project-marker.js";
 const CONTENT_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "content");
 const CHECKPOINT_EVERY_TURNS = 5;
-const turn = readHookInput().turn_number;
+const input = readHookInput();
+const turn = input.turn_number;
 if (!Number.isInteger(turn) || turn < 1)
     process.exit(0);
 if (turn % CHECKPOINT_EVERY_TURNS !== 0)
     process.exit(0);
+// The checkpoint asks the model to write to project memory, which needs a
+// project. Unbound repositories get nothing, same as the other hooks.
+if (!readProjectMarker(input.cwd ?? process.cwd()))
+    process.exit(0);
 let directive;
 try {
     directive = readFileSync(join(CONTENT_ROOT, "checkpoint.md"), "utf8").trim();

package/dist/hooks/stop.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/hooks/stop.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1F,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC,WAAW,CAAC;AACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAK,IAAe,GAAG,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrE,IAAK,IAAe,GAAG,sBAAsB,KAAK,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAErE,IAAI,SAAiB,CAAC;AACtB,IAAI,CAAC;IACH,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/E,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/hooks/stop.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1F,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;AAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;AAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAK,IAAe,GAAG,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACrE,IAAK,IAAe,GAAG,sBAAsB,KAAK,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAErE,0EAA0E;AAC1E,sEAAsE;AACtE,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpE,IAAI,SAAiB,CAAC;AACtB,IAAI,CAAC;IACH,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/E,CAAC;AAAC,MAAM,CAAC;IACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/hooks/user-prompt-submit.js

@@ -1,18 +1,36 @@
 #!/usr/bin/env node
 import { callTool, McpCallError } from "../mcp-client.js";
 import { discoverDeployment } from "../discovery.js";
-import { emitContext, readHookInput } from "../hook-io.js";
+import { emitContext, promptText, readHookInput } from "../hook-io.js";
 import { readProjectMarker } from "../project-marker.js";
 import { claimOnce } from "../session-marker.js";
 import { writeSessionStatus } from "../session-status.js";
 const MAX_CONTEXT_CHARS = 6000;
+// The composite tool searches memory, documents and source concurrently, so it
+// is slower than a bare recall. This hook blocks the user's prompt, so the
+// ceiling stays close to the old one rather than tracking the server's own
+// per-section timeout.
+const GATHER_TIMEOUT_MS = 10000;
 const RECALL_TIMEOUT_MS = 8000;
+// Keywords are extracted from the task, so a pasted stack trace or diff adds
+// upload on a path that blocks the prompt without adding signal.
+const MAX_TASK_CHARS = 2000;
 const input = readHookInput();
-if (!claimOnce(input.session_id, "recall"))
-    process.exit(0);
 const apiKey = process.env["CLAUDE_PLUGIN_OPTION_JITERA_API_KEY"] ?? "";
 if (!apiKey)
     process.exit(0);
+// Without .jitera.json this repository is not bound to a project, so there is
+// no project whose context could be gathered. Bail before discovery rather
+// than spend a network round trip guessing at a project nobody chose; session
+// start is where the user is told how to bind it.
+const marker = readProjectMarker(input.cwd ?? process.cwd());
+if (!marker)
+    process.exit(0);
+// Claimed only once there is something to claim it for: burning the session's
+// single gather on an unbound repo would mean running init mid-session never
+// took effect.
+if (!claimOnce(input.session_id, "recall"))
+    process.exit(0);
 let url;
 const override = process.env["JITERA_MCP_URL"];
 if (override) {
@@ -31,24 +49,60 @@ else {
         process.exit(0);
     }
 }
-let memory;
-const startedAt = Date.now();
-try {
-    memory = await callTool({
-        url,
-        apiKey,
-        projectUuid: readProjectMarker(input.cwd ?? process.cwd())?.project,
-        name: "recall_jitera_memory",
-        args: {},
-        timeoutMs: RECALL_TIMEOUT_MS,
-    });
+const transport = { url, apiKey, projectUuid: marker.project };
+const task = promptText(input).slice(0, MAX_TASK_CHARS);
+// The blind recall serves two purposes: it is what deployments predating the
+// composite tool answer, and it is the right call when there is no prompt text
+// to gather for. It stays query-less on purpose — a server without the widening
+// ladder can return less for a query than for no query.
+const recall = () => callTool({
+    ...transport,
+    name: "recall_jitera_memory",
+    args: {},
+    timeoutMs: RECALL_TIMEOUT_MS,
+});
+// The fallback exists for deployments that predate the composite tool, so it
+// is worth a second round trip only when the tool is genuinely absent. Falling
+// back on a timeout would stack RECALL_TIMEOUT_MS on top of GATHER_TIMEOUT_MS
+// while the user's prompt is blocked.
+function toolIsMissing(error) {
+    if (!(error instanceof McpCallError))
+        return false;
+    const detail = error.detail;
+    if (detail?.code === -32601 || detail?.code === -32602)
+        return true;
+    return /unknown tool|tool not found|method not found/i.test(error.message);
 }
-catch (error) {
+function giveUp(error) {
     const message = error instanceof McpCallError ? error.message : String(error);
     writeSessionStatus(input.session_id, { recallError: message });
-    process.stderr.write(`jitera-connect: could not load project memory: ${message}\n`);
+    process.stderr.write(`jitera-connect: could not load project context: ${message}\n`);
     process.exit(0);
 }
+let memory;
+const startedAt = Date.now();
+try {
+    // Gathering for an empty task makes the server ask for one, and that answer
+    // would be injected as though it were project context.
+    memory = task
+        ? await callTool({
+            ...transport,
+            name: "gather_jitera_context",
+            args: { task, budget: MAX_CONTEXT_CHARS },
+            timeoutMs: GATHER_TIMEOUT_MS,
+        })
+        : await recall();
+}
+catch (gatherError) {
+    if (!task || !toolIsMissing(gatherError))
+        giveUp(gatherError);
+    try {
+        memory = await recall();
+    }
+    catch (error) {
+        giveUp(error);
+    }
+}
 writeSessionStatus(input.session_id, {
     recallMs: Date.now() - startedAt,
     recallChars: memory.length,
@@ -57,9 +111,10 @@ writeSessionStatus(input.session_id, {
 if (!memory)
     process.exit(0);
 const body = memory.length > MAX_CONTEXT_CHARS
-    ? `${memory.slice(0, MAX_CONTEXT_CHARS)}\n\n[truncated, call recall_jitera_memory for the rest]`
+    ? `${memory.slice(0, MAX_CONTEXT_CHARS)}\n\n[truncated, call gather_jitera_context for the rest]`
     : memory;
-emitContext("UserPromptSubmit", `Stored project memory for this workspace, loaded at session start:\n\n${body}\n\n` +
-    `Treat this as current. Call recall_jitera_memory again if you need a narrower or fuller view, ` +
-    `and persist new decisions with remember_jitera_memory.`);
+emitContext("UserPromptSubmit", `Project context for this workspace, gathered at session start:\n\n${body}\n\n` +
+    `Treat this as current. It was gathered for the first prompt of this session, so call ` +
+    `gather_jitera_context yourself when the task moves on to a different area, and persist ` +
+    `new decisions with remember_jitera_memory.`);
 //# sourceMappingURL=user-prompt-submit.js.map

package/dist/hooks/user-prompt-submit.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-prompt-submit.js","sourceRoot":"","sources":["../../src/hooks/user-prompt-submit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-prompt-submit.js","sourceRoot":"","sources":["../../src/hooks/user-prompt-submit.ts"],"names":[],"mappings":"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"}

package/dist/project-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-marker.d.ts","sourceRoot":"","sources":["../src/project-marker.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAM9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAyBlF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,MAAM,UAAQ,GACb,iBAAiB,CAuBnB"}
+{"version":3,"file":"project-marker.d.ts","sourceRoot":"","sources":["../src/project-marker.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAM9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAsClF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,MAAM,UAAQ,GACb,iBAAiB,CAuBnB"}

package/dist/project-marker.js

@@ -16,8 +16,15 @@ export function readProjectMarker(startDir) {
             catch {
                 return undefined;
             }
-            const environment = parsed["environment"];
-            const project = parsed["project"];
+            // `null` parses cleanly and then throws on property access, and a array
+            // or a bare scalar is not a marker either. Malformed reads as unbound,
+            // the same as unparseable, because hooks must never break a session.
+            if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+                return undefined;
+            }
+            const fields = parsed;
+            const environment = fields["environment"];
+            const project = fields["project"];
             return {
                 path,
                 ...(typeof environment === "string" && SAFE_ENVIRONMENT.test(environment)
@@ -26,6 +33,11 @@ export function readProjectMarker(startDir) {
                 ...(typeof project === "string" ? { project } : {}),
             };
         }
+        // Never look past the repository root. `init` writes the marker there, so
+        // a stray .jitera.json in a parent directory (or $HOME) would otherwise
+        // bind every repository beneath it to a project nobody chose for them.
+        if (existsSync(join(dir, ".git")))
+            return undefined;
         const parent = dirname(dir);
         if (parent === dir)
             return undefined;

package/dist/project-marker.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-marker.js","sourceRoot":"","sources":["../src/project-marker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAE9C,8EAA8E;AAC9E,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAWhD,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QACxC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,MAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAC;YAC7E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YAClC,OAAO;gBACL,IAAI;gBACJ,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC;oBACvE,CAAC,CAAC,EAAE,WAAW,EAAE;oBACjB,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAOD,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAqB,EACrB,MAAM,GAAG,KAAK;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAEzC,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,MAA0B,CAAC;IAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA4B,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ;QACX,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;IACF,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,KAAK,UAAU,CAAC;IACtC,IAAI,OAAO,IAAI,CAAC,MAAM;QAAE,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"project-marker.js","sourceRoot":"","sources":["../src/project-marker.ts"],"names":[],"mappings":"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"}

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.0.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,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.