@nac3/forge-cli 1.0.50 → 1.0.52

package/dist/nac3/manifest_lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest_lazy.d.ts","sourceRoot":"","sources":["../../src/nac3/manifest_lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAA4B,KAAK,QAAQ,EAAwC,MAAM,wBAAwB,CAAC;AAEvH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,oDAAoD;AACpD,wBAAgB,mBAAmB,IAAI,YAAY,CAIlD;AAsCD;;0DAE0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAMpD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;qCAMiC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAmBxE;AAED;;2DAE2D;AAC3D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;8DAI8D;AAC9D,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,mBAAwB,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI3G"}
+{"version":3,"file":"manifest_lazy.d.ts","sourceRoot":"","sources":["../../src/nac3/manifest_lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAA4B,KAAK,QAAQ,EAAwC,MAAM,wBAAwB,CAAC;AAEvH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,oDAAoD;AACpD,wBAAgB,mBAAmB,IAAI,YAAY,CAIlD;AAsCD;;0DAE0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAMpD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;qCAMiC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;uDAGmD;IACnD,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CAoBxE;AAED;;2DAE2D;AAC3D,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;8DAI8D;AAC9D,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,mBAAwB,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI3G"}

package/dist/nac3/manifest_lazy.js

@@ -104,9 +104,9 @@ export function buildVerbStub(verb) {
 export function buildManifestStub(opts = {}) {
     const m = fullManifest();
     const includeMcp = opts.includeMcpVerbs === true;
-    const verbs = includeMcp
-        ? m.verbs
-        : m.verbs.filter((v) => !v.id.startsWith('yujin.mcp.'));
+    const includeSession = opts.includeSessionVerbs === true;
+    const verbs = m.verbs.filter((v) => (includeMcp || !v.id.startsWith('yujin.mcp.'))
+        && (includeSession || !v.id.startsWith('yujin.session.')));
     const lines = [];
     lines.push('NAC3 MANIFEST (stub mode -- ' + verbs.length + ' verbs)');
     lines.push('format: <verb_id> [<policy><side_effects>] <label> args:<{required,[optional]}>');

package/dist/nac3/manifest_lazy.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest_lazy.js","sourceRoot":"","sources":["../../src/nac3/manifest_lazy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manifest_lazy.js","sourceRoot":"","sources":["../../src/nac3/manifest_lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAuD,MAAM,wBAAwB,CAAC;AAIvH,oDAAoD;AACpD,MAAM,UAAU,mBAAmB;IACjC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;sCACsC;AACtC,SAAS,WAAW,CAAC,CAAa;IAChC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,cAAc,CAAC,CAAQ,OAAO,GAAG,CAAC;QACvC,KAAK,SAAS,CAAC,CAAa,OAAO,GAAG,CAAC;QACvC,KAAK,mBAAmB,CAAC,CAAG,OAAO,GAAG,CAAC;QACvC,KAAK,aAAa,CAAC,CAAS,OAAO,GAAG,CAAC;QACvC,KAAK,eAAe,CAAC,CAAO,OAAO,GAAG,CAAC;QACvC,KAAK,oBAAoB,CAAC,CAAE,OAAO,GAAG,CAAC;QACvC,OAAO,CAAC,CAAoB,OAAO,GAAG,CAAC;IACzC,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,SAAS,eAAe,CAAC,EAAkB;IACzC,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAU,OAAO,EAAE,CAAC;QAChC,KAAK,KAAK,CAAC,CAAW,OAAO,GAAG,CAAC;QACjC,KAAK,YAAY,CAAC,CAAI,OAAO,GAAG,CAAC;QACjC,KAAK,SAAS,CAAC,CAAO,OAAO,GAAG,CAAC;QACjC,KAAK,SAAS,CAAC,CAAO,OAAO,GAAG,CAAC;QACjC,KAAK,cAAc,CAAC,CAAE,OAAO,GAAG,CAAC;QACjC,KAAK,KAAK,CAAC,CAAW,OAAO,GAAG,CAAC;QACjC,OAAO,CAAC,CAAc,OAAO,GAAG,CAAC;IACnC,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,SAAS,aAAa,CAAC,IAAc;IACnC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;0DAE0D;AAC1D,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAA6B,CAAC;IAC3D,MAAM,OAAO,GAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,GAAG,GAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,GAAK,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AACnE,CAAC;AAkBD,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,OAA4B,EAAE;IAC9D,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;IACjD,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,KAAK,IAAI,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACjC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;WAC3C,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,8BAA8B,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,2GAA2G,CAAC,CAAC;IACxH,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iFAAiF,CAAC,CAAC;IAC9F,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC7F,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;2DAE2D;AAC3D,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;8DAI8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,OAA4B,EAAE;IACnE,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAC9E,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export declare const VERSION = "1.0.50";
+export declare const VERSION = "1.0.52";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export const VERSION = '1.0.50';
+export const VERSION = '1.0.52';
 //# sourceMappingURL=version.js.map

package/docs/doctrine/session-orchestration.md

@@ -0,0 +1,86 @@
+# Doctrine: session orchestration (yujin.session.*)
+
+When it is optimal, you may launch other `yf chat` instances as
+HEADLESS AGENT sub-sessions to do orthogonal, well-scoped work in
+parallel with this conversation, and collect their results over the
+coordination bridge. This is the `yujin.session.*` verb family.
+
+This doctrine is about WHEN to spawn and how to keep it safe and
+cheap. It is distinct from `agent-orchestrator` (product-side agents
+the generated software dispatches on the user's machine).
+
+## Off by default
+
+The whole capability is gated by `multiagent.enabled` in the limits
+config (Ajustes > Limites), DEFAULT OFF. While off, the
+`yujin.session.*` verbs are hidden from the manifest, this doctrine is
+not injected, the system prompt tells you it is OFF, and the handlers
+refuse. So you only see + use these verbs when the user has explicitly
+turned multi-agent on. If the user asks for parallel sub-sessions while
+it is off, tell them to enable it in Ajustes > Limites.
+
+## The verbs
+
+- `yujin.session.spawn { task, project_root?, budget_tokens?, label? }`
+  -- launch a sub-session for one self-contained task. Returns a
+  handle immediately (NON-blocking). The user approves each spawn
+  (it spends BYOK tokens autonomously).
+- `yujin.session.collect { handle?, wait_ms? }` -- read the results
+  sub-sessions have published. `wait_ms` blocks up to that long for
+  at least one result; default 0 = return whatever has arrived.
+- `yujin.session.list` -- what you have spawned + whether each is
+  still alive.
+- `yujin.session.stop { handle }` -- terminate one.
+
+## Spawn ONLY when it pays off
+
+A sub-session boots a whole headless server and spends tokens, so the
+overhead must be justified. Spawn when ALL of these hold:
+
+1. **Orthogonal** -- the subtask is independent of the work you are
+   doing right now; it does not need the live conversation context.
+   (The child gets ONLY the `task` string you write -- be specific.)
+2. **Parallelizable** -- it can run while you keep working, and you
+   genuinely benefit from not blocking on it (e.g. a wide read /
+   research / analysis sweep over a different subsystem).
+3. **No write collision** -- it will not edit the same files you are
+   editing. If both might write, scope them to different paths or do
+   it yourself.
+4. **Fits a budget** -- set `budget_tokens` to bound the spend.
+
+Do NOT spawn for:
+
+- Trivial tasks (a single read, a one-line answer) -- the overhead
+  costs more than doing it inline.
+- Anything that needs the user's live judgement or the chat history.
+- Work you could do with one of your own verbs in this turn.
+
+Typical good uses: "map how subsystem X wires together and report the
+key files + entry points", "search the whole repo for every place
+pattern Y appears and summarise", "read these 8 docs and extract the
+constraints". Launch one per independent angle, then `collect`.
+
+## The child's scope (enforced, not advisory)
+
+A sub-session runs with a RESTRICTED verb scope (enforced in
+`nac3_invoke` via `YF_AGENT_MODE`):
+
+- CAN: read / search / write files in its project root, run SAFE
+  shell, query the graph / pendings / reader.
+- CANNOT: `git push` / `git commit`, destructive actions, `fs.move`,
+  re-anchor the project, mutate the workflow / pending / keys, run
+  lifecycle servers, or spawn its OWN sub-sessions (no grandchildren).
+
+So the child is a safe builder/analyst. Anything outward or
+irreversible stays with YOU, the parent, where the user can approve
+it. Have the child RETURN its deliverable; you surface it (pizarron,
+etc.) and you do the push/commit.
+
+## Lifecycle
+
+Sub-sessions are one-shot: a child runs its task to completion (a
+`[SESSION_DONE]` marker), publishes its result, and exits. The full
+result is written to disk; the bridge signal carries a summary + the
+path. Always `collect` what you spawn -- do not leave results
+unread. If a child is no longer useful or is burning budget, `stop`
+it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.0.50",
+  "version": "1.0.52",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",

package/src/i18n/catalogs/ar.json

@@ -219,5 +219,16 @@
   "panel.project.title": "المشاريع",
   "panel.project.add": "إضافة مشروع...",
   "panel.project.addPrompt": "المسار المطلق للمشروع المراد إضافته:",
-  "panel.project.switching": "جارٍ تبديل المشروع..."
-}
+  "panel.project.switching": "جارٍ تبديل المشروع...",
+  "startup.tab.files": "الملفات",
+  "panel.project.remove": "إزالة من القائمة",
+  "panel.project.removeConfirm": "إزالة هذا المشروع من القائمة؟ (لا يحذف الملفات من القرص)",
+  "panel.project.removed": "تمت إزالة المشروع من القائمة",
+  "panel.files.refresh": "تحديث",
+  "panel.files.loading": "جارٍ التحميل...",
+  "panel.files.error": "تعذّر قراءة الملفات.",
+  "panel.files.empty": "(لا ملفات)",
+  "panel.files.truncated": "(القائمة مقتطعة)",
+  "panel.files.opened": "تم الفتح",
+  "panel.files.openFailed": "تعذّر فتح الملف."
+}

package/src/i18n/catalogs/de.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Projekte",
   "panel.project.add": "Projekt hinzufuegen...",
   "panel.project.addPrompt": "Absoluter Pfad des hinzuzufuegenden Projekts:",
-  "panel.project.switching": "Projekt wird gewechselt..."
-}
+  "panel.project.switching": "Projekt wird gewechselt...",
+  "startup.tab.files": "Dateien",
+  "panel.project.remove": "Aus der Liste entfernen",
+  "panel.project.removeConfirm": "Dieses Projekt aus der Liste entfernen? (löscht keine Dateien auf der Festplatte)",
+  "panel.project.removed": "Projekt aus der Liste entfernt",
+  "panel.files.refresh": "Aktualisieren",
+  "panel.files.loading": "Wird geladen...",
+  "panel.files.error": "Dateien konnten nicht gelesen werden.",
+  "panel.files.empty": "(keine Dateien)",
+  "panel.files.truncated": "(Liste gekürzt)",
+  "panel.files.opened": "Geöffnet",
+  "panel.files.openFailed": "Datei konnte nicht geöffnet werden."
+}

package/src/i18n/catalogs/en.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Projects",
   "panel.project.add": "Add project...",
   "panel.project.addPrompt": "Absolute path of the project to add:",
-  "panel.project.switching": "Switching project..."
-}
+  "panel.project.switching": "Switching project...",
+  "startup.tab.files": "Files",
+  "panel.project.remove": "Remove from list",
+  "panel.project.removeConfirm": "Remove this project from the list? (does not delete files on disk)",
+  "panel.project.removed": "Project removed from the list",
+  "panel.files.refresh": "Refresh",
+  "panel.files.loading": "Loading...",
+  "panel.files.error": "Could not read the files.",
+  "panel.files.empty": "(no files)",
+  "panel.files.truncated": "(list truncated)",
+  "panel.files.opened": "Opened",
+  "panel.files.openFailed": "Could not open the file."
+}

package/src/i18n/catalogs/es.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Proyectos",
   "panel.project.add": "Anadir proyecto...",
   "panel.project.addPrompt": "Ruta absoluta del proyecto a anadir:",
-  "panel.project.switching": "Cambiando de proyecto..."
-}
+  "panel.project.switching": "Cambiando de proyecto...",
+  "startup.tab.files": "Archivos",
+  "panel.project.remove": "Quitar de la lista",
+  "panel.project.removeConfirm": "Quitar este proyecto de la lista? (no borra los archivos del disco)",
+  "panel.project.removed": "Proyecto quitado de la lista",
+  "panel.files.refresh": "Actualizar",
+  "panel.files.loading": "Cargando...",
+  "panel.files.error": "No pude leer los archivos.",
+  "panel.files.empty": "(sin archivos)",
+  "panel.files.truncated": "(lista truncada)",
+  "panel.files.opened": "Abierto",
+  "panel.files.openFailed": "No se pudo abrir el archivo."
+}

package/src/i18n/catalogs/fr.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Projets",
   "panel.project.add": "Ajouter un projet...",
   "panel.project.addPrompt": "Chemin absolu du projet a ajouter :",
-  "panel.project.switching": "Changement de projet..."
-}
+  "panel.project.switching": "Changement de projet...",
+  "startup.tab.files": "Fichiers",
+  "panel.project.remove": "Retirer de la liste",
+  "panel.project.removeConfirm": "Retirer ce projet de la liste ? (ne supprime pas les fichiers sur le disque)",
+  "panel.project.removed": "Projet retiré de la liste",
+  "panel.files.refresh": "Actualiser",
+  "panel.files.loading": "Chargement...",
+  "panel.files.error": "Impossible de lire les fichiers.",
+  "panel.files.empty": "(aucun fichier)",
+  "panel.files.truncated": "(liste tronquée)",
+  "panel.files.opened": "Ouvert",
+  "panel.files.openFailed": "Impossible d'ouvrir le fichier."
+}

package/src/i18n/catalogs/hi.json

@@ -219,5 +219,16 @@
   "panel.project.title": "प्रोजेक्ट",
   "panel.project.add": "प्रोजेक्ट जोड़ें...",
   "panel.project.addPrompt": "जोड़ने के लिए प्रोजेक्ट का पूर्ण पथ:",
-  "panel.project.switching": "प्रोजेक्ट बदला जा रहा है..."
-}
+  "panel.project.switching": "प्रोजेक्ट बदला जा रहा है...",
+  "startup.tab.files": "फ़ाइलें",
+  "panel.project.remove": "सूची से हटाएँ",
+  "panel.project.removeConfirm": "इस प्रोजेक्ट को सूची से हटाएँ? (डिस्क की फ़ाइलें नहीं मिटतीं)",
+  "panel.project.removed": "प्रोजेक्ट सूची से हटाया गया",
+  "panel.files.refresh": "रिफ़्रेश",
+  "panel.files.loading": "लोड हो रहा है...",
+  "panel.files.error": "फ़ाइलें नहीं पढ़ सके।",
+  "panel.files.empty": "(कोई फ़ाइल नहीं)",
+  "panel.files.truncated": "(सूची संक्षिप्त)",
+  "panel.files.opened": "खोला गया",
+  "panel.files.openFailed": "फ़ाइल नहीं खोल सके।"
+}

package/src/i18n/catalogs/it.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Progetti",
   "panel.project.add": "Aggiungi progetto...",
   "panel.project.addPrompt": "Percorso assoluto del progetto da aggiungere:",
-  "panel.project.switching": "Cambio progetto..."
-}
+  "panel.project.switching": "Cambio progetto...",
+  "startup.tab.files": "File",
+  "panel.project.remove": "Rimuovi dall'elenco",
+  "panel.project.removeConfirm": "Rimuovere questo progetto dall'elenco? (non elimina i file su disco)",
+  "panel.project.removed": "Progetto rimosso dall'elenco",
+  "panel.files.refresh": "Aggiorna",
+  "panel.files.loading": "Caricamento...",
+  "panel.files.error": "Impossibile leggere i file.",
+  "panel.files.empty": "(nessun file)",
+  "panel.files.truncated": "(elenco troncato)",
+  "panel.files.opened": "Aperto",
+  "panel.files.openFailed": "Impossibile aprire il file."
+}

package/src/i18n/catalogs/ja.json

@@ -219,5 +219,16 @@
   "panel.project.title": "プロジェクト",
   "panel.project.add": "プロジェクトを追加...",
   "panel.project.addPrompt": "追加するプロジェクトの絶対パス:",
-  "panel.project.switching": "プロジェクトを切り替え中..."
-}
+  "panel.project.switching": "プロジェクトを切り替え中...",
+  "startup.tab.files": "ファイル",
+  "panel.project.remove": "リストから削除",
+  "panel.project.removeConfirm": "このプロジェクトをリストから削除しますか？（ディスク上のファイルは削除されません）",
+  "panel.project.removed": "プロジェクトをリストから削除しました",
+  "panel.files.refresh": "更新",
+  "panel.files.loading": "読み込み中...",
+  "panel.files.error": "ファイルを読み込めませんでした。",
+  "panel.files.empty": "（ファイルなし）",
+  "panel.files.truncated": "（リストは省略されています）",
+  "panel.files.opened": "開きました",
+  "panel.files.openFailed": "ファイルを開けませんでした。"
+}

package/src/i18n/catalogs/pt.json

@@ -219,5 +219,16 @@
   "panel.project.title": "Projetos",
   "panel.project.add": "Adicionar projeto...",
   "panel.project.addPrompt": "Caminho absoluto do projeto a adicionar:",
-  "panel.project.switching": "Trocando de projeto..."
-}
+  "panel.project.switching": "Trocando de projeto...",
+  "startup.tab.files": "Arquivos",
+  "panel.project.remove": "Remover da lista",
+  "panel.project.removeConfirm": "Remover este projeto da lista? (nao apaga os arquivos do disco)",
+  "panel.project.removed": "Projeto removido da lista",
+  "panel.files.refresh": "Atualizar",
+  "panel.files.loading": "Carregando...",
+  "panel.files.error": "Nao foi possivel ler os arquivos.",
+  "panel.files.empty": "(sem arquivos)",
+  "panel.files.truncated": "(lista truncada)",
+  "panel.files.opened": "Aberto",
+  "panel.files.openFailed": "Nao foi possivel abrir o arquivo."
+}

package/src/i18n/catalogs/zh.json

@@ -219,5 +219,16 @@
   "panel.project.title": "项目",
   "panel.project.add": "添加项目...",
   "panel.project.addPrompt": "要添加的项目的绝对路径：",
-  "panel.project.switching": "正在切换项目..."
-}
+  "panel.project.switching": "正在切换项目...",
+  "startup.tab.files": "文件",
+  "panel.project.remove": "从列表中移除",
+  "panel.project.removeConfirm": "从列表中移除此项目？（不会删除磁盘上的文件）",
+  "panel.project.removed": "已从列表中移除项目",
+  "panel.files.refresh": "刷新",
+  "panel.files.loading": "加载中...",
+  "panel.files.error": "无法读取文件。",
+  "panel.files.empty": "（无文件）",
+  "panel.files.truncated": "（列表已截断）",
+  "panel.files.opened": "已打开",
+  "panel.files.openFailed": "无法打开文件。"
+}