@nac3/forge-cli 0.2.0-alpha.4 → 0.2.0-alpha.5

package/dist/chat/panel.js

@@ -1093,7 +1093,7 @@ async function dispatchReaderIntent(utterance, intent) {
     }
     /* Update the active reader doc on a successful open so
        subsequent voice commands ("siguiente", etc) target it. */
-    if (intent.tool === 'forge.reader.open' && !data.is_error) {
+    if (intent.tool === 'forge_reader_open' && !data.is_error) {
       const docId = data.result && data.result.doc_id;
       if (docId) state.activeReaderDocId = String(docId);
     }
@@ -1311,7 +1311,7 @@ async function ingestSpecFile(file) {
     state.toolHistory.push({
       turnIndex: state.messages.length - 1,
       rounds: [{
-        tool: 'forge.spec.ingest',
+        tool: 'forge_spec_ingest',
         input: { filename: ing.filename, format: ing.format },
         display: 'parsed ' + ing.format + ': ' + (ing.title || ing.filename),
         is_error: false,

package/dist/chat/server.js

@@ -466,17 +466,17 @@ async function handleVoiceStt(req, res, ctx) {
  * runs.
  */
 const FORGE_TOOL_DIRECT_ALLOWLIST = new Set([
-    'forge.reader.open',
-    'forge.reader.list_documents',
-    'forge.reader.read_section',
-    'forge.reader.next_block',
-    'forge.reader.search',
-    'forge.reader.bookmark_set',
-    'forge.reader.bookmark_jump',
-    'forge.reader.recap',
+    'forge_reader_open',
+    'forge_reader_list_documents',
+    'forge_reader_read_section',
+    'forge_reader_next_block',
+    'forge_reader_search',
+    'forge_reader_bookmark_set',
+    'forge_reader_bookmark_jump',
+    'forge_reader_recap',
     /* Fase F.8 -- HTML user manuals in 10 languages. Read-only,
        same safety profile as the reader tools. */
-    'forge.manual.open',
+    'forge_manual_open',
 ]);
 async function handleForgeToolDispatch(req, res, ctx) {
     let body;

package/dist/chat/tools/git.js

@@ -65,7 +65,7 @@ async function resolveRepoDir(repoDir, ctx) {
  * Specs
  * ============================================================ */
 export const GIT_COMMIT_SPEC = {
-    name: 'forge.git_commit',
+    name: 'forge_git_commit',
     description: 'Commit staged changes (or all tracked changes with `all`=true) in the given git checkout. Returns the commit hash on success.',
     input_schema: {
         type: 'object',
@@ -79,7 +79,7 @@ export const GIT_COMMIT_SPEC = {
     requires_approval: true,
 };
 export const GIT_PUSH_SPEC = {
-    name: 'forge.git_push',
+    name: 'forge_git_push',
     description: 'Push the current branch to the configured remote. Set `force`=true ONLY for force-push (irreversible -- gated by the V1.10 liveness check).',
     input_schema: {
         type: 'object',
@@ -94,7 +94,7 @@ export const GIT_PUSH_SPEC = {
     requires_approval: true,
 };
 export const GIT_PULL_SPEC = {
-    name: 'forge.git_pull',
+    name: 'forge_git_pull',
     description: 'Pull from the configured remote. Fast-forward only by default.',
     input_schema: {
         type: 'object',
@@ -108,7 +108,7 @@ export const GIT_PULL_SPEC = {
     requires_approval: true,
 };
 export const GIT_LOG_SPEC = {
-    name: 'forge.git_log',
+    name: 'forge_git_log',
     description: 'List the last N commits of the given checkout. Default 10, max 50.',
     input_schema: {
         type: 'object',

package/dist/chat/tools/github.js

@@ -32,7 +32,7 @@ const VAULT_SLOT = 'github_token';
 const GITHUB_API = 'https://api.github.com';
 /* ------------------ Tool specs ------------------ */
 export const CREATE_GITHUB_REPO_SPEC = {
-    name: 'forge.create_github_repo',
+    name: 'forge_create_github_repo',
     description: 'Create a new repository under the authenticated GitHub user. Requires vault slot github_token with repo scope. Returns the new repository metadata including clone_url.',
     input_schema: {
         type: 'object',
@@ -46,7 +46,7 @@ export const CREATE_GITHUB_REPO_SPEC = {
     requires_approval: true,
 };
 export const CLONE_REPO_SPEC = {
-    name: 'forge.clone_repo',
+    name: 'forge_clone_repo',
     description: 'Clone a remote git repository to a local directory. Public repos need no auth. Private repos use the github_token slot when present. Returns the resolved target_dir + the first commit hash.',
     input_schema: {
         type: 'object',
@@ -59,7 +59,7 @@ export const CLONE_REPO_SPEC = {
     requires_approval: true,
 };
 export const BRANCH_STATUS_SPEC = {
-    name: 'forge.branch_status',
+    name: 'forge_branch_status',
     description: 'Read the current git branch + dirty-tree status of a local checkout. Returns branch name, ahead/behind counters vs upstream when present, list of dirty files (max 50).',
     input_schema: {
         type: 'object',

package/dist/chat/tools/lifecycle.js

@@ -37,7 +37,7 @@ let active = null;
  * Specs
  * ============================================================ */
 export const RUN_APP_SPEC = {
-    name: 'forge.run_app',
+    name: 'forge_run_app',
     description: 'Launch the project dev server. Auto-detects the package manager (npm / yarn / pnpm) and the script (dev / start / serve). Returns pid + best-effort URL.',
     input_schema: {
         type: 'object',
@@ -51,7 +51,7 @@ export const RUN_APP_SPEC = {
     requires_approval: true,
 };
 export const STOP_APP_SPEC = {
-    name: 'forge.stop_app',
+    name: 'forge_stop_app',
     description: 'Stop the running app spawned by forge.run_app. Returns the final logs tail.',
     input_schema: {
         type: 'object',
@@ -63,7 +63,7 @@ export const STOP_APP_SPEC = {
     requires_approval: true,
 };
 export const RESTART_APP_SPEC = {
-    name: 'forge.restart_app',
+    name: 'forge_restart_app',
     description: 'Stop the running app + relaunch with the same (or new) options.',
     input_schema: {
         type: 'object',

package/dist/chat/tools/manual.js

@@ -47,7 +47,7 @@ const MANUAL_PATH_CANDIDATES = (lang) => {
     return manualBaseDirs().map((dir) => path.join(dir, fname));
 };
 export const MANUAL_OPEN_SPEC = {
-    name: 'forge.manual.open',
+    name: 'forge_manual_open',
     description: 'Open the Yujin Forge user manual in the requested language (default: current user language). Resolves to docs/manuals/manual.<lang>.html and opens it through the reader pipeline so the user can navigate by voice. Available languages: es, en, pt, fr, ja, zh, hi, ar, de, it.',
     input_schema: {
         type: 'object',

package/dist/chat/tools/reader.js

@@ -45,7 +45,7 @@ export function _resetReaderForTests() {
  * Specs
  * ============================================================ */
 export const READER_OPEN_SPEC = {
-    name: 'forge.reader.open',
+    name: 'forge_reader_open',
     description: 'Open a document for reading. Auto-detects format (txt / md / source / ...). Returns the doc_id + title + section count + first block.',
     input_schema: {
         type: 'object',
@@ -57,13 +57,13 @@ export const READER_OPEN_SPEC = {
     requires_approval: false,
 };
 export const READER_LIST_DOCS_SPEC = {
-    name: 'forge.reader.list_documents',
+    name: 'forge_reader_list_documents',
     description: 'List all documents currently open in this chat session.',
     input_schema: { type: 'object', properties: {}, required: [] },
     requires_approval: false,
 };
 export const READER_READ_SECTION_SPEC = {
-    name: 'forge.reader.read_section',
+    name: 'forge_reader_read_section',
     description: 'Return the blocks of a section. With no index, returns the current section under the cursor.',
     input_schema: {
         type: 'object',
@@ -76,7 +76,7 @@ export const READER_READ_SECTION_SPEC = {
     requires_approval: false,
 };
 export const READER_NEXT_BLOCK_SPEC = {
-    name: 'forge.reader.next_block',
+    name: 'forge_reader_next_block',
     description: 'Advance the reader cursor one block forward. Returns the new block contents.',
     input_schema: {
         type: 'object',
@@ -88,7 +88,7 @@ export const READER_NEXT_BLOCK_SPEC = {
     requires_approval: false,
 };
 export const READER_SEARCH_SPEC = {
-    name: 'forge.reader.search',
+    name: 'forge_reader_search',
     description: 'Full-text search across a document. Returns top hits sorted by match count.',
     input_schema: {
         type: 'object',
@@ -102,7 +102,7 @@ export const READER_SEARCH_SPEC = {
     requires_approval: false,
 };
 export const READER_BOOKMARK_SET_SPEC = {
-    name: 'forge.reader.bookmark_set',
+    name: 'forge_reader_bookmark_set',
     description: 'Set a named bookmark at the current cursor position.',
     input_schema: {
         type: 'object',
@@ -115,7 +115,7 @@ export const READER_BOOKMARK_SET_SPEC = {
     requires_approval: false,
 };
 export const READER_BOOKMARK_JUMP_SPEC = {
-    name: 'forge.reader.bookmark_jump',
+    name: 'forge_reader_bookmark_jump',
     description: 'Jump the cursor to a previously-set bookmark.',
     input_schema: {
         type: 'object',
@@ -128,7 +128,7 @@ export const READER_BOOKMARK_JUMP_SPEC = {
     requires_approval: false,
 };
 export const READER_RECAP_SPEC = {
-    name: 'forge.reader.recap',
+    name: 'forge_reader_recap',
     description: 'Return the last N spoken blocks from the reader playback buffer. Default window 10. mode="summary" returns a Claude-generated 1-2 sentence summary instead of literal blocks (charges tokens; gated by env YF_ENABLE_CLAUDE_RECAP=1).',
     input_schema: {
         type: 'object',

package/dist/chat/tools.js

@@ -41,7 +41,7 @@ import { MANUAL_OPEN_SPEC, runManualOpen, } from './tools/manual.js';
  * forge.read_manifest
  * ============================================================ */
 export const READ_MANIFEST_SPEC = {
-    name: 'forge.read_manifest',
+    name: 'forge_read_manifest',
     description: 'Read the NAC-3 manifest from the active project. Returns the manifest JSON (plugin_slug, version, elements array). Optionally filter to a specific plugin slug via the `plugin_slug` argument.',
     input_schema: {
         type: 'object',
@@ -105,7 +105,7 @@ export async function runReadManifest(args, ctx) {
  * forge.consult_nac_spec
  * ============================================================ */
 export const CONSULT_NAC_SPEC = {
-    name: 'forge.consult_nac_spec',
+    name: 'forge_consult_nac_spec',
     description: 'Search the NAC-3 specification (docs/SPEC.md in the project) for paragraphs matching a free-text query. Returns up to 5 matches with their section headings + snippet. Useful when the chat needs to ground its answer in the canonical contract.',
     input_schema: {
         type: 'object',
@@ -231,7 +231,7 @@ function clampMax(n) {
  * forge.list_files
  * ============================================================ */
 export const LIST_FILES_SPEC = {
-    name: 'forge.list_files',
+    name: 'forge_list_files',
     description: 'List source files under a directory of the active project. Bounded read-only walk with a hard cap on file count + a glob filter for the basename. Useful when the chat needs to know what is in the project before opening anything.',
     input_schema: {
         type: 'object',
@@ -358,7 +358,7 @@ export function compileBasenameGlob(glob) {
  * forge.read_file
  * ============================================================ */
 export const READ_FILE_SPEC = {
-    name: 'forge.read_file',
+    name: 'forge_read_file',
     description: 'Read a single source file from the active project. Path must be relative to the project root and stay within it. Refuses binary files (NUL byte detection) and files larger than max_bytes (default 64KB). Use forge.list_files first when you do not already know the path.',
     input_schema: {
         type: 'object',

package/dist/version.d.ts

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export declare const VERSION = "0.2.0-alpha.4";
+export declare const VERSION = "0.2.0-alpha.5";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -4,5 +4,5 @@
  * into the npm metadata) so we don't end up with two versions
  * drifting.
  */
-export const VERSION = '0.2.0-alpha.4';
+export const VERSION = '0.2.0-alpha.5';
 //# sourceMappingURL=version.js.map

package/dist/voice/intents.d.ts

@@ -35,7 +35,7 @@
  * the contract is the literal string the chat dispatcher
  * accepts. If a tool is renamed there, this list must follow.
  */
-export type ReaderToolName = 'forge.reader.open' | 'forge.reader.list_documents' | 'forge.reader.read_section' | 'forge.reader.next_block' | 'forge.reader.search' | 'forge.reader.bookmark_set' | 'forge.reader.bookmark_jump' | 'forge.reader.recap' | 'forge.manual.open';
+export type ReaderToolName = 'forge_reader_open' | 'forge_reader_list_documents' | 'forge_reader_read_section' | 'forge_reader_next_block' | 'forge_reader_search' | 'forge_reader_bookmark_set' | 'forge_reader_bookmark_jump' | 'forge_reader_recap' | 'forge_manual_open';
 export interface MatchedIntent {
     tool: ReaderToolName;
     args: Record<string, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "0.2.0-alpha.4",
+  "version": "0.2.0-alpha.5",
   "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>",
@@ -50,7 +50,7 @@
   },
   "engines": {
     "node": ">=18.17",
-    "pnpm": ">=10"
+    "pnpm": ">=9"
   },
   "packageManager": "pnpm@11.3.0",
   "files": [