@appinit/cli 1.0.0 → 1.2.0

package/LICENSE

@@ -0,0 +1,33 @@
+MIT License (Modified for Proprietary CLI Distribution)
+
+Copyright © 2025 Pradeep, AppInit OS Authors
+All Rights Reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining an official copy
+of the compiled CLI distributable package `@appinit/cli` (the "Software"), to install,
+execute, and use the CLI for project initialization on their local machine or authorized
+environments, subject to the following conditions:
+
+✅ Allowed:
+
+1. Installing and executing the official CLI via npm (`npx appinit`, `npm i -g @appinit/cli`)
+2. Using the CLI to initialize new projects and install owner-approved template packs/addons
+3. Modifying generated _output_ inside initialized projects (not the CLI core)
+4. Creating addons/plugins/templates using AppInit public contracts (future SDK/specs)
+
+🚫 Not Allowed (Strict Restrictions):
+
+1. Copying, cloning, or extracting the CLI internal implementation or bundled engine code
+2. Republishing internal implementation, architecture, or behavior in any form
+3. Creating derivative tools, generator systems, or runtime competitors using the CLI internals
+4. Distributing modified versions of AppInit core implementation as independent or competing systems
+5. Reverse engineering, de-bundling, or re-creating internal resolution, addon, or engine layers
+
+The above copyright notice and this permission notice shall be included in all written
+references to the official AppInit CLI distributable only.
+
+Liability Disclaimer:
+
+THE SOFTWARE IS PROVIDED "AS IS" (COMPILED CLI DISTRIBUTABLE ONLY), WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES, OR OTHER LIABILITY ARISING FROM USE OF THE DISTRIBUTED CLI.

package/README.md

@@ -0,0 +1,111 @@
+# **@appinit/cli**
+
+The official command-line interface for **AppInit OS**.
+
+`@appinit/cli` provides all executable commands used to create, configure, and manage AppInit projects.
+It connects the user experience (prompts, commands, flags) with the internal systems (core engine, resolver, and template/module execution pipeline).
+
+This is the primary entrypoint for developers using AppInit.
+
+---
+
+## 📦 About
+
+`@appinit/cli` enables:
+
+- project creation
+
+  ```
+  appinit create <project-name>
+  ```
+
+- feature / module installation
+
+  ```
+  appinit add <feature>
+  ```
+
+- generating components, routes, API handlers
+
+  ```
+  appinit generate <component|page|api>
+  ```
+
+- doctor, sync, upgrade, debugging tools
+
+  ```
+  appinit doctor
+  appinit sync
+  appinit upgrade
+  ```
+
+- interactive prompts powered by **APS (AppInit Prompt Spec)**
+
+- smart suggestions & stack detection
+
+- safe, deterministic scaffolding
+
+The CLI orchestrates interactions between:
+
+- **resolver** (`@appinit/resolver`)
+- **engine** (`@appinit/engine`)
+- **core context** (`@appinit/core`)
+- **types & specs** (`@appinit/types`)
+
+---
+
+## 📘 Usage
+
+Global usage:
+
+```sh
+npx appinit create my-app
+```
+
+Local workspace usage:
+
+```sh
+pnpm appinit create my-app
+```
+
+Internal usage:
+
+```ts
+import { runCLI } from "@appinit/cli";
+
+runCLI(process.argv.slice(2));
+```
+
+---
+
+## 🛠 Development
+
+Build:
+
+```
+pnpm -F @appinit/cli build
+```
+
+Watch mode:
+
+```
+pnpm -F @appinit/cli dev
+```
+
+Type-check:
+
+```
+pnpm -F @appinit/cli typecheck
+```
+
+Run locally (linked):
+
+```
+pnpm -F @appinit/cli appinit create test
+```
+
+---
+
+## 📄 License
+
+Internal – © AppInit

package/bin/appinit.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import("../dist/index.js")
+	.then((mod) => {
+		if (mod && mod.start) {
+			mod.start(process.argv);
+		} else {
+			console.error("AppInit: No 'start' export found in CLI module.");
+			process.exit(1);
+		}
+	})
+	.catch((err) => {
+		console.error("AppInit CLI failed:", err);
+		process.exit(1);
+	});

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export {};
-//# sourceMappingURL=index.d.ts.map
+#!/usr/bin/env node
+declare function start(argv: string[]): void;
+
+export { start };