@codenotch/codenotch.cli 1.0.33

package/dist/utils/ServeUtils.js

@@ -0,0 +1,191 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const ConsoleUtils_1 = __importDefault(require("./ConsoleUtils"));
+class ServeUtils {
+    static async serveApp(directory, options) {
+        const port = options.port || 5000;
+        const isAbsolutePath = directory && (directory.startsWith('/') || directory.match(/^[a-zA-Z]:\\/));
+        const targetDir = (0, path_1.resolve)(isAbsolutePath ? directory : (0, path_1.join)(process.cwd(), directory));
+        const indexPath = (0, path_1.resolve)(targetDir, options.index || 'index.html');
+        if (!(0, fs_1.existsSync)(targetDir)) {
+            console.log(chalk_1.default.red(`Error: Target directory not found (${targetDir})`));
+            process.exit(1);
+        }
+        if (!(0, fs_1.existsSync)(indexPath)) {
+            console.log(chalk_1.default.red(`Error: Index file not found (${indexPath})`));
+            process.exit(1);
+        }
+        const envVariables = this.getEnvVariables((0, path_1.resolve)(targetDir, '.env'));
+        const aumlObject = this.getAumlVariables((0, path_1.resolve)(targetDir, 'auml.json'));
+        console.log(chalk_1.default.green('Starting production server...'));
+        console.log(chalk_1.default.blue(`Server: http://localhost:${port}`));
+        console.log(chalk_1.default.yellow('Using built-in static file server with custom endpoint\n'));
+        await this.startExpressServer(targetDir, indexPath, {
+            port: port,
+            envVariables: envVariables,
+            auml: aumlObject
+        });
+    }
+    static getAumlVariables(aumlPath) {
+        if ((0, fs_1.existsSync)(aumlPath)) {
+            console.log(chalk_1.default.green(`Loaded auml variables from "${aumlPath}":`));
+            try {
+                let json = (0, fs_1.readFileSync)(aumlPath, 'utf8');
+                return JSON.parse(json);
+            }
+            catch (error) {
+                console.log(chalk_1.default.red(`Error parsing auml file: ${error}`));
+            }
+        }
+        else {
+            console.log(chalk_1.default.yellow(`Warning: No .auml file found. Auml variables will not be loaded.`));
+        }
+        return undefined;
+    }
+    static getEnvVariables(envPath) {
+        let envVariables = [];
+        if ((0, fs_1.existsSync)(envPath)) {
+            let envContent = (0, fs_1.readFileSync)(envPath, 'utf8');
+            envContent.split('\n').forEach(line => {
+                let [key, value] = line.split('=');
+                if (key && value) {
+                    envVariables.push({ name: key.trim(), value: value.trim() });
+                }
+            });
+            console.log(chalk_1.default.green(`Loaded environment variables from "${envPath}":`));
+            envVariables.forEach(env => {
+                console.log(chalk_1.default.blue(`- ${env.name}=${env.value}`));
+            });
+        }
+        else {
+            console.log(chalk_1.default.yellow(`Warning: No .env file found. Environment variables will not be loaded.`));
+        }
+        return envVariables;
+    }
+    static async startExpressServer(targetDir, indexPath, options) {
+        // Express server
+        try {
+            const express = await Promise.resolve().then(() => __importStar(require('express')));
+            const app = express.default();
+            // Serve static files
+            app.use(express.static(targetDir));
+            app.get('/api/env', (req, res) => {
+                let envData = {};
+                options.envVariables.forEach(env => {
+                    envData[env.name] = env.value;
+                });
+                if (options.auml && Object.keys(options.auml).length > 0) {
+                    for (let key of Object.keys(options.auml)) {
+                        envData[`GLOBAL.${key}`] = JSON.stringify(options.auml[key]);
+                    }
+                }
+                res.json(envData);
+            });
+            // Fallback to index.html for SPA - handle all unmatched routes
+            app.use((req, res, next) => {
+                // Skip fallback for static files (images, favicons, etc.)
+                const staticFileExtensions = ['.ico', '.png', '.jpg', '.jpeg', '.gif', '.svg', '.css', '.js', '.map', '.txt', '.xml', '.json'];
+                const hasStaticExtension = staticFileExtensions.some(ext => req.path.toLowerCase().endsWith(ext));
+                // Only serve index.html for GET requests that aren't API calls or static files
+                if (req.method === 'GET' && !req.path.startsWith('/api/') && !hasStaticExtension) {
+                    console.log(chalk_1.default.gray(`Serving fallback for: ${req.path}`));
+                    // Use a more robust approach for sending files with special characters
+                    try {
+                        res.sendFile(indexPath, {
+                            maxAge: 0,
+                            etag: false
+                        }, (err) => {
+                            if (err) {
+                                console.error(chalk_1.default.red(`Error serving ${indexPath}: ${err.message}`));
+                                if (!res.headersSent) {
+                                    res.status(404).send('Page not found');
+                                }
+                            }
+                        });
+                    }
+                    catch (error) {
+                        console.error(chalk_1.default.red(`Catch error: ${error}`));
+                        if (!res.headersSent) {
+                            res.status(500).send('Internal Server Error');
+                        }
+                    }
+                }
+                else {
+                    // For static files that don't exist, return 404 directly
+                    if (hasStaticExtension) {
+                        res.status(404).send('File not found');
+                    }
+                    else {
+                        next();
+                    }
+                }
+            });
+            const server = app.listen(options.port, () => {
+                console.log(chalk_1.default.green(`Server running on http://localhost:${options.port}`) + ConsoleUtils_1.default.proposeOpenUri('Open in browser?', `http://localhost:${options.port}`));
+            });
+            const killServer = () => {
+                console.log(chalk_1.default.yellow('\nStopping server...'));
+                // Force exit graceful shutdown takes too long
+                const forceExit = setTimeout(() => {
+                    console.log(chalk_1.default.red('Force stopping server...'));
+                    process.exit(0);
+                }, 500);
+                server.close(() => {
+                    clearTimeout(forceExit);
+                    process.exit(0);
+                });
+                // For Node.js 18.02+ - close all connections immediately
+                if (typeof server.closeAllConnections === 'function') {
+                    server.closeAllConnections();
+                }
+            };
+            process.on('SIGINT', () => killServer());
+            process.on('SIGTERM', () => killServer());
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`Error starting server: ${error}`));
+            process.exit(1);
+        }
+    }
+}
+exports.default = ServeUtils;
+//# sourceMappingURL=ServeUtils.js.map

package/dist/utils/ServeUtils.js.map

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

package/dist/utils/ShellUtils.d.ts

@@ -0,0 +1,3 @@
+export default abstract class ShellUtils {
+    static exec(location: string, command: string, info?: string, silent?: boolean): Promise<void>;
+}

package/dist/utils/ShellUtils.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+class ShellUtils {
+    static async exec(location, command, info, silent = false) {
+        if (info)
+            console.log(info + "...");
+        await new Promise((resolve, reject) => {
+            (0, child_process_1.exec)(command, { cwd: location }, (error, stdout, stderr) => {
+                if (error) {
+                    if (!silent) {
+                        console.error(`Error while ${info}: ${error}`);
+                    }
+                    reject(error);
+                }
+                else {
+                    if (!silent) {
+                        console.log(stdout);
+                        console.error(stderr);
+                    }
+                    resolve(null);
+                }
+            });
+        });
+    }
+}
+exports.default = ShellUtils;
+//# sourceMappingURL=ShellUtils.js.map

package/dist/utils/ShellUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellUtils.js","sourceRoot":"","sources":["../../src/utils/ShellUtils.ts"],"names":[],"mappings":";;AACA,iDAAqC;AAErC,MAA8B,UAAU;IAC7B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAa,EAAE,SAAkB,KAAK;QAE9F,IAAG,IAAI;YACH,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAC9B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAClC,IAAA,oBAAI,EAAC,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAU,EAAE,MAAW,EAAE,MAAW,EAAE,EAAE;gBACtE,IAAI,KAAK,EAAE,CAAC;oBACR,IAAI,CAAC,MAAM,EAAE,CAAC;wBACV,OAAO,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;oBACnD,CAAC;oBACD,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,MAAM,EAAE,CAAC;wBACV,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;wBACpB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC1B,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClB,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAtBD,6BAsBC"}

package/dist/utils/StringUtils.d.ts

@@ -0,0 +1,9 @@
+export default abstract class StringUtils {
+    static firstUpper(str: string): string;
+    static toRelativePath(path: string, parentPath: string): string;
+    static getNameWithoutExtention(filename: string): string;
+    static getFilenameFromUri(uri: string): string;
+    static getFolder(path: string): string;
+    static normalizePath(path: string): string;
+    static sha256(message: string): Promise<string>;
+}

package/dist/utils/StringUtils.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const os_1 = require("os");
+class StringUtils {
+    static firstUpper(str) {
+        if (str.trim() === '')
+            return str;
+        return `${str[0].toUpperCase()}${str.substring(1)}`;
+    }
+    static toRelativePath(path, parentPath) {
+        path = path.replaceAll("\\", "/");
+        parentPath = parentPath.replaceAll("\\", "/");
+        path = path.replace(parentPath, '');
+        if (path.startsWith("/")) {
+            path = path.substring(1);
+        }
+        return path;
+    }
+    static getNameWithoutExtention(filename) {
+        filename = this.getFilenameFromUri(filename);
+        if (!filename.includes('.')) {
+            return filename;
+        }
+        let ind = filename.lastIndexOf('.');
+        return filename.substring(0, ind);
+    }
+    static getFilenameFromUri(uri) {
+        uri = uri.replaceAll('\\', '/');
+        return uri.includes('/') ? uri.split('/').pop() : uri;
+    }
+    static getFolder(path) {
+        path = path.replaceAll("/", "\\");
+        if (path.includes('\\') === false) {
+            return '';
+        }
+        path = path.substring(0, path.lastIndexOf("\\"));
+        path = this.normalizePath(path);
+        return path;
+    }
+    static normalizePath(path) {
+        if (typeof path !== 'string' || path.trim() === '') {
+            return '';
+        }
+        if ((0, os_1.platform)() === 'win32') {
+            path = path.replaceAll("/", '\\');
+        }
+        else {
+            path = path.replaceAll('\\', '/');
+        }
+        return path;
+    }
+    static async sha256(message) {
+        // encode as UTF-8
+        const msgBuffer = new TextEncoder().encode(message);
+        // hash the message
+        const hashBuffer = await crypto.subtle.digest('SHA-256', msgBuffer);
+        // convert ArrayBuffer to Array
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        // convert bytes to hex string                  
+        const hashHex = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+        return hashHex;
+    }
+}
+exports.default = StringUtils;
+//# sourceMappingURL=StringUtils.js.map

package/dist/utils/StringUtils.js.map

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

package/docs/ARCHITECTURE.md

@@ -0,0 +1,179 @@
+# Codenotch CLI — Architecture (agent-oriented)
+
+> Fast-orientation map for AI agents. Optimized for finding the right file quickly, not human onboarding prose.
+
+## Purpose
+
+`codenotch-cli` (binaries `codenotch-cli` and `cn`) is a Node.js/TypeScript command-line tool for the **Codenotch platform**. It manages a local **runtime** (downloaded from GitHub releases of `EchinoHub/service-core`), compiles/packages Codenotch projects (manifest + BPMN processes + AUML/React apps + data tables) into deployable zips, deploys them to the runtime, and builds/serves React applications embedded in projects.
+
+## Tech stack & runtime
+
+| Aspect | Detail |
+|--------|--------|
+| Language | TypeScript (`strict`), target ES2022, module CommonJS |
+| Runtime | Node.js (>= types/node 20), needs Node on PATH |
+| Compiler | `tsc` → `dist/` (`rootDir: src`, `outDir: dist`) |
+| CLI framework | `commander` v12 |
+| Build | `npm run build` (runs `prebuild` → `clean` via `rimraf`) |
+| Dev | `npm run dev` (`tsx src/index.ts`) |
+| Start | `npm start` (`node dist/index.js`) |
+| Install locally | `npm run build` then `npm link` |
+
+## Entry points & dispatch
+
+| File | Role |
+|------|------|
+| [src/index.ts](src/index.ts) | **Real entry point, bootstrap only.** Loads `.env` from CLI root, creates the `commander` program (name/description/version), calls `registerAllCommands`, ends with `program.parse()`. |
+| [src/commands/index.ts](src/commands/index.ts) | `registerAllCommands(program)`: registers each command sector in `--help` order (system → react → runtime → project). |
+| [src/bin/cli.ts](src/bin/cli.ts) | Thin shim: `import '../index.js'`. Compiled to `dist/bin/cli.js`, the published `bin` target. |
+| [bin/cli.js](bin/cli.js) | Source-tree shim mirroring the above (`import '../index.js'`). |
+| `package.json` `bin` | Maps `codenotch-cli` and `cn` → `dist/bin/cli.js`. |
+
+Flow: `cn <cmd>` → `dist/bin/cli.js` → `dist/index.js` → `registerAllCommands` → commander parses argv → matched `.action()` → delegates to a `*Utils` static method.
+
+## Command tree (defined under [src/commands/](src/commands))
+
+One folder per sector, one file per command. Each command file exports a `register*(parent: Command)` function; each sector's `index.ts` creates the command group and calls them.
+
+| Command | File | Delegates to |
+|---------|------|-------------|
+| `info` | [system/info.ts](src/commands/system/info.ts) | inline (system info) |
+| `read` | [system/read.ts](src/commands/system/read.ts) | inline (readline test) |
+| `react serve [dir]` | [react/serve.ts](src/commands/react/serve.ts) | `ServeUtils.serveApp` |
+| `react build [file]` | [react/build.ts](src/commands/react/build.ts) | `BuildUtils.buildApp` |
+| `runtime info\|status` | [runtime/info.ts](src/commands/runtime/info.ts) | `RuntimeUtils.isRuntimeInstalled/getRuntimeVersion/...` |
+| `runtime update\|install` | [runtime/update.ts](src/commands/runtime/update.ts) | `RuntimeUtils.installLatestRuntime` |
+| `runtime start\|stop\|clear` | [runtime/start.ts](src/commands/runtime/start.ts), [stop.ts](src/commands/runtime/stop.ts), [clear.ts](src/commands/runtime/clear.ts) | `RuntimeUtils.startRuntime/stopRuntime/clearRuntime` |
+| `runtime latest` | [runtime/latest.ts](src/commands/runtime/latest.ts) | `RuntimeUtils.getLatestRuntimeRelease` |
+| `portal` (root command) | [runtime/portal.ts](src/commands/runtime/portal.ts) | `RuntimeUtils.getRuntimeBaseUrl` + `OsUtils.openInBrowser` |
+| `project inspect` | [project/inspect.ts](src/commands/project/inspect.ts) | `ProjectUtils.inspectProject` |
+| `project open` | [project/open.ts](src/commands/project/open.ts) | `ProjectUtils.getProjectServiceName` + browser |
+| `project start` | [project/start.ts](src/commands/project/start.ts) | `RuntimeUtils.startProject` |
+| `project refresh\|patch` | [project/refresh.ts](src/commands/project/refresh.ts) | `RuntimeUtils.patchProject` (TODO, stubbed) |
+| `project test` | [project/test.ts](src/commands/project/test.ts) | `RuntimeUtils.testProject` |
+| `project compile` | [project/compile.ts](src/commands/project/compile.ts) | `ProjectCompilationUtils.compileProject` |
+| `project package\|build` | [project/package.ts](src/commands/project/package.ts) | `ProjectUtils.packageProject` |
+| `project deploy [service] [zip]` | [project/deploy.ts](src/commands/project/deploy.ts) | `RuntimeUtils.deployProject` |
+| `project new` | [project/new.ts](src/commands/project/new.ts) | TODO stub |
+| `project remove` | [project/remove.ts](src/commands/project/remove.ts) | `RuntimeUtils.removeProject` |
+
+Planned commands (validate, query, …) are tracked in [docs/TODO.md](docs/TODO.md).
+
+## Layers
+
+```mermaid
+flowchart TD
+    Entry[src/index.ts bootstrap] --> CLI[src/commands commander wiring]
+    CLI --> Utils
+    subgraph Utils[src/utils]
+      RU[RuntimeUtils]
+      PU[ProjectUtils]
+      PCU[ProjectCompilationUtils]
+      BU[BuildUtils]
+      SU[ServeUtils]
+    end
+    Utils --> Models[src/models]
+    RU --> GH[GitHubAuthUtils]
+    PCU --> OAPI[OpenAPIUtils]
+    PCU --> I18N[I18nUtils]
+    Utils --> FU[FileUtils]
+    Utils --> Sh[ShellUtils]
+    Utils --> OS[OsUtils]
+```
+
+- **Commands layer** ([src/commands/](src/commands)) — commander wiring only: one folder per sector (`system/`, `react/`, `runtime/`, `project/`), one file per command. No business logic.
+- **Utils layer** ([src/utils/](src/utils)) — all real logic lives here as `abstract class` with `static` methods.
+- **Models layer** ([src/models/](src/models)) — plain TS interfaces/classes describing manifests, DB tables, and OpenAPI.
+
+## Directory map
+
+| Path | Responsibility |
+|------|---------------|
+| [src/index.ts](src/index.ts) | Bootstrap: `.env`, program creation, `registerAllCommands`, `parse`. |
+| [src/bin/cli.ts](src/bin/cli.ts) | Published bin shim → imports `index`. |
+| [bin/cli.js](bin/cli.js) | Source-tree bin shim. |
+| [src/commands/index.ts](src/commands/index.ts) | `registerAllCommands`: registers all sectors in `--help` order. |
+| [src/commands/system/](src/commands/system) | Root-level misc commands: `info`, `read`. |
+| [src/commands/react/](src/commands/react) | `react` group: `build`, `serve`. |
+| [src/commands/runtime/](src/commands/runtime) | `runtime` group: `info`, `update`, `start`, `stop`, `clear`, `latest` + root `portal`. |
+| [src/commands/project/](src/commands/project) | `project` group: `inspect`, `open`, `start`, `refresh`, `test`, `compile`, `package`, `deploy`, `new`, `remove`. |
+| [src/commands/project/shared.ts](src/commands/project/shared.ts) | `withProjectPathOption` helper + `IProjectCommandOptions` (shared `-p, --project-path`). |
+| [src/utils/RuntimeUtils.ts](src/utils/RuntimeUtils.ts) | Install/update/start/stop/clear runtime; meta (`runtime.json`/`runtime.pid`) in `~/.codenotch` (or `CODENOTCH_PATH`); start/test/deploy/remove projects; admin token. |
+| [src/utils/ProjectUtils.ts](src/utils/ProjectUtils.ts) | `packageProject` (copy→compile→zip in tmp), `getManifest`, `getProjectServiceName`, `inspectProject`. Reads `manifest.json`. |
+| [src/utils/ProjectCompilationUtils.ts](src/utils/ProjectCompilationUtils.ts) | Core compiler: generate `ProjectManifest`, DB schema XML, OpenAPI; parse BPMN via `@echino/codenotch.core.workflow`; **in-place** file mutation. |
+| [src/utils/BuildUtils.ts](src/utils/BuildUtils.ts) | `cn react build`: finds workspace manifest, scaffolds Vite/TS/index for a React app, fetches tenant/env vars, builds. |
+| [src/utils/ServeUtils.ts](src/utils/ServeUtils.ts) | `cn react serve`: Express static server with SPA fallback; reads AUML/env variables. |
+| [src/utils/OpenAPIUtils.ts](src/utils/OpenAPIUtils.ts) | Generate OpenAPI 3.0 spec from compiled processes/variables. |
+| [src/utils/I18nUtils.ts](src/utils/I18nUtils.ts) | Parse `*.i18n.csv` files (papaparse) and merge translations by key. |
+| [src/utils/GitHubAuthUtils.ts](src/utils/GitHubAuthUtils.ts) | GitHub OAuth device flow (`@octokit/auth-oauth-device`); token cached in OS keychain (`cross-keychain`); honors `GITHUB_TOKEN`. |
+| [src/utils/FileUtils.ts](src/utils/FileUtils.ts) | Filesystem helpers: zip (`adm-zip`), copy/move/delete folders, recursive file listing, path normalize. |
+| [src/utils/ShellUtils.ts](src/utils/ShellUtils.ts) | `exec(location, command)` wrapper around `child_process.exec`. |
+| [src/utils/OsUtils.ts](src/utils/OsUtils.ts) | OS abstraction: `openInBrowser` (platform-specific). |
+| [src/utils/ConsoleUtils.ts](src/utils/ConsoleUtils.ts) | Chalk-styled console helpers (`check`, `checkWarning`, `proposeCommand`, `proposeOpenUri`). |
+| [src/utils/StringUtils.ts](src/utils/StringUtils.ts) | String/path helpers: `firstUpper`, `toRelativePath`, `normalizePath`, `getNameWithoutExtention`. |
+| [src/models/Codenotch.ts](src/models/Codenotch.ts) | `ProjectManifest` + sub-types (apis, applications, react apps, processes, datastores, roles…), `IScenarioProjectManifest`, `ApplicationManifest`/PWA/AUML, `IWorkspaceCache`, `ProjectState`. |
+| [src/models/DbModels.ts](src/models/DbModels.ts) | `TableDefinition`, `FieldTypes` enum, field/relation interfaces → used to emit DB schema XML. |
+| [src/models/OpenApiModels.ts](src/models/OpenApiModels.ts) | `OpenAPISpec` (OpenAPI 3.0), `APIInfo`, parameter/response interfaces. |
+
+## Key flows
+
+### CLI command → execution
+1. `cn project package` → commander matches in [src/commands/project/package.ts](src/commands/project/package.ts).
+2. `.action()` reads `--project-path` (default `process.cwd()`) and `--output-path`.
+3. Calls `ProjectUtils.packageProject(projectPath, outputPath)`.
+
+### Package a project ([ProjectUtils.packageProject](src/utils/ProjectUtils.ts))
+`mkdtemp` → `FileUtils.copyFolder` (excludes `.git/node_modules/dist/build/out`) → `ProjectCompilationUtils.compileProject` (in-place on the copy) → `FileUtils.zipFolder` → cleanup tmp. Returns `CompilationResult { errors, warnings }`.
+
+### Compile ([ProjectCompilationUtils.compileProject](src/utils/ProjectCompilationUtils.ts))
+Builds `CompilationContext` → `generateManifest` (scans files, parses BPMN via `@echino/codenotch.core.workflow`) → `OpenApiUtils.generateOpenApi` → `generateDbSchema` (XML via `js2xmlparser` from `DbModels`). Writes `manifest.json`, `openapi.json`, `dbschema.xml`.
+
+### Runtime lifecycle ([RuntimeUtils](src/utils/RuntimeUtils.ts))
+Install dir = `CODENOTCH_PATH` or `~/.codenotch`. `installLatestRuntime` authenticates via `GitHubAuthUtils.getToken`, downloads release asset, decompresses (`decompress`). State tracked in `runtime.pid` + `runtime.json`. `startRuntime` spawns the executable; project ops talk to it over HTTP (`getRuntimeBaseUrl`, default `http://127.0.0.1:5005`).
+
+## Conventions & patterns
+
+- **Static utility classes**: every util is `export default abstract class XxxUtils` (or named export) with only `static` methods. No instances, no DI.
+- **Command → Util delegation**: command files ([src/commands/](src/commands)) stay thin; logic lives in utils.
+- **Command registration**: each command file exports `register<Name>(parent: Command)`; each sector `index.ts` exports `register<Sector>Commands(program)`; file names are lowercase and mirror the command name (`runtime/start.ts` ↔ `cn runtime start`).
+- **Project path option**: shared via `withProjectPathOption(command)` helper ([src/commands/project/shared.ts](src/commands/project/shared.ts)); defaults to `process.cwd()`.
+- **Error handling**: user-facing failures print `chalk.red(...)` then `process.exit(1)`; deeper code throws `Error` with wrapped messages.
+- **Output styling**: `chalk` everywhere; structured helpers in `ConsoleUtils`. Many commands support `--json` for machine output.
+- **i18n**: CSV-based (`*.i18n.csv`) parsed by `I18nUtils`; embedded into compiled AUML output.
+- **OS/shell abstraction**: `OsUtils` (browser/platform), `ShellUtils` (exec), `FileUtils`/`StringUtils` (paths, normalized with `FileUtils.slash()`).
+- **Config**: `.env` loaded from CLI root in `index.ts` (`dotenv`). Key vars: `CODENOTCH_PATH`, `GITHUB_TOKEN`.
+- **TODOs**: several commands are stubbed (`project new`, `project refresh/patch`); planned commands are listed in [docs/TODO.md](docs/TODO.md).
+
+## External integrations
+
+| Dependency | Used for | Where |
+|-----------|----------|-------|
+| `commander` | CLI parsing/dispatch | [src/index.ts](src/index.ts), [src/commands/](src/commands) |
+| `@octokit/auth-oauth-device` + `cross-keychain` | GitHub device-flow auth, token in OS keychain | [src/utils/GitHubAuthUtils.ts](src/utils/GitHubAuthUtils.ts) |
+| `@echino/codenotch.core.workflow` | BPMN → workflow model parsing | [src/utils/ProjectCompilationUtils.ts](src/utils/ProjectCompilationUtils.ts) |
+| `express` | Static/SPA dev server | [src/utils/ServeUtils.ts](src/utils/ServeUtils.ts) |
+| `adm-zip` | Zip project package | [src/utils/FileUtils.ts](src/utils/FileUtils.ts) |
+| `decompress` | Extract downloaded runtime | [src/utils/RuntimeUtils.ts](src/utils/RuntimeUtils.ts) |
+| `node-fetch` / global `fetch` | HTTP to GitHub & runtime | RuntimeUtils, BuildUtils, GitHubAuthUtils |
+| `js2xmlparser` | DB schema XML emit | [src/utils/ProjectCompilationUtils.ts](src/utils/ProjectCompilationUtils.ts) |
+| `papaparse` | Parse i18n CSV | [src/utils/I18nUtils.ts](src/utils/I18nUtils.ts) |
+| `chalk` | Colored output | everywhere |
+| `fs-extra` | Extended FS ops | [src/utils/BuildUtils.ts](src/utils/BuildUtils.ts) |
+| `dotenv` | Load `.env` | [src/index.ts](src/index.ts) |
+
+## "Where to look" index
+
+| Task | Start here |
+|------|-----------|
+| Add/modify a CLI command or option | [src/commands/](src/commands) — folder = sector, file = command; new sector → register it in [src/commands/index.ts](src/commands/index.ts) |
+| Planned/upcoming commands | [docs/TODO.md](docs/TODO.md) |
+| Change runtime install/start/stop/deploy | [src/utils/RuntimeUtils.ts](src/utils/RuntimeUtils.ts) |
+| Change how projects are compiled/packaged | [src/utils/ProjectCompilationUtils.ts](src/utils/ProjectCompilationUtils.ts), [src/utils/ProjectUtils.ts](src/utils/ProjectUtils.ts) |
+| OpenAPI generation | [src/utils/OpenAPIUtils.ts](src/utils/OpenAPIUtils.ts), [src/models/OpenApiModels.ts](src/models/OpenApiModels.ts) |
+| DB schema / table types | [src/utils/ProjectCompilationUtils.ts](src/utils/ProjectCompilationUtils.ts), [src/models/DbModels.ts](src/models/DbModels.ts) |
+| React app build/serve | [src/utils/BuildUtils.ts](src/utils/BuildUtils.ts), [src/utils/ServeUtils.ts](src/utils/ServeUtils.ts) |
+| GitHub auth issues | [src/utils/GitHubAuthUtils.ts](src/utils/GitHubAuthUtils.ts) |
+| Manifest shape / project model | [src/models/Codenotch.ts](src/models/Codenotch.ts) |
+| i18n CSV handling | [src/utils/I18nUtils.ts](src/utils/I18nUtils.ts) |
+| File/zip/path helpers | [src/utils/FileUtils.ts](src/utils/FileUtils.ts), [src/utils/StringUtils.ts](src/utils/StringUtils.ts) |
+| Build/dev/start scripts | `package.json` `scripts` |

package/docs/TODO.md

@@ -0,0 +1,18 @@
+# TODO — upcoming commands
+
+- validate bpmn
+- validate .table
+- validate .jschema
+- validate manifest.json
+- validate i18n
+- validate full projet
+- generate manifest.cache.json
+- query table (sioql on local cluster)
+- query document (sioql on local cluster)
+- **get npmrc token ? (until codenotch-react fully public )
+- auto generate bpmn diagram
+- generate db schema
+- compile :
+  - generate db schema
+  - auto generate bpmn diagram
+  - generate manifest.cache.json

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@codenotch/codenotch.cli",
+  "version": "1.0.33",
+  "description": "A CLI tool for code management",
+  "main": "dist/index.js",
+  "bin": {
+    "codenotch-cli": "./dist/bin/cli.js",
+    "cn": "./dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "prepare": "npm run build",
+    "pack:check": "npm pack --dry-run",
+    "release": "npm run build && npm run pack:check && npm publish"
+  },
+  "keywords": [
+    "cli",
+    "tool",
+    "code"
+  ],
+  "author": "Codenotch SA",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EchinoHub/codenotch-cli.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@codenotch/codenotch.core": "1.0.2",
+    "@codenotch/codenotch.core.workflow": "1.0.3",
+    "@octokit/auth-oauth-device": "^8.0.3",
+    "@types/express": "^5.0.6",
+    "adm-zip": "^0.5.17",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "cross-keychain": "^1.1.0",
+    "decompress": "^4.2.1",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "fs-extra": "^10.0.0",
+    "js2xmlparser": "^5.0.0",
+    "node-fetch": "^3.3.2",
+    "papaparse": "^5.3.1"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.8",
+    "@types/decompress": "^4.2.7",
+    "@types/fs-extra": "^9.0.13",
+    "@types/json-schema": "^7.0.6",
+    "@types/node": "^20.19.34",
+    "@types/papaparse": "^5.3.1",
+    "rimraf": "^5.0.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/bin/cli.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// Redirection vers le fichier principal
+import '../index.js';

package/src/commands/index.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { registerSystemCommands } from './system';
+import { registerReactCommands } from './react';
+import { registerRuntimeCommands } from './runtime';
+import { registerProjectCommands } from './project';
+
+// Registration order defines the order in `--help`
+export function registerAllCommands(program: Command) {
+    registerSystemCommands(program);
+    registerReactCommands(program);
+    registerRuntimeCommands(program);
+    registerProjectCommands(program);
+}

package/src/commands/project/compile.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ProjectCompilationUtils from '../../utils/ProjectCompilationUtils';
+import { IProjectCommandOptions, withProjectPathOption } from './shared';
+
+export function registerCompile(project: Command) {
+    withProjectPathOption(project
+        .command('compile')
+        .description('Compile the project, modify the source files in-place'))
+        .action(async (options: IProjectCommandOptions) => {
+            const compilation = await ProjectCompilationUtils.compileProject(options.projectPath);
+            if (compilation.errors.length > 0) {
+                console.error(chalk.red("Compilation failed with errors:"));
+                compilation.errors.forEach(err => console.error(chalk.red(`- ${err}`)));
+            }
+            else {
+                console.log(chalk.green(`Project compiled successfully`));
+            }
+        });
+}

package/src/commands/project/deploy.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import RuntimeUtils from '../../utils/RuntimeUtils';
+
+export function registerDeploy(project: Command) {
+    project
+        .command('deploy [service] [zip]')
+        .description('Deploy the project package to the runtime')
+        .action(async (service: string, zip: string) => {
+            await RuntimeUtils.deployProject(service, zip);
+        });
+}