@danceroutine/tango-cli 0.1.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pedro Del Moral Lopez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 `@danceroutine/tango-cli` provides the `tango` command-line executable.
 
-This package gives Tango one unified command surface for project setup and maintenance workflows. It exists so that application developers can learn one CLI instead of having to remember which package owns which command. Today that means migrations and project scaffolding. Over time it also gives Tango a stable place to compose future command modules.
+This package gives Tango one unified command surface for project setup and maintenance workflows. It owns the public CLI, while the behavior is composed from domain packages such as migrations and codegen.
 
 ## Install
 
@@ -10,10 +10,6 @@ This package gives Tango one unified command surface for project setup and maint
 pnpm add -D @danceroutine/tango-cli
 ```
 
-The CLI is typically a development dependency because it supports setup, generation, and migration workflows rather than application runtime behavior.
-
-## What the CLI is for
-
 Use the `tango` binary when you want to:
 
 - scaffold a new Tango project
@@ -21,19 +17,17 @@ Use the `tango` binary when you want to:
 - apply migrations to a database
 - inspect a migration plan or status
 
-The CLI package owns the executable itself. The feature packages still own their underlying behavior. For example, `@danceroutine/tango-migrations` owns migration generation and execution, while `@danceroutine/tango-cli` is the package that exposes those workflows through the `tango` binary.
-
 ## Common commands
 
 ```bash
 tango new my-app --framework express --package-manager pnpm --dialect sqlite
-tango make:migrations --dialect sqlite --models ./src/models.ts --dir ./migrations --name add_posts
-tango migrate --dialect sqlite --dir ./migrations --db ./app.sqlite
-tango plan --dialect sqlite --dir ./migrations --db ./app.sqlite
-tango status --dialect sqlite --dir ./migrations --db ./app.sqlite
+tango make:migrations --config ./tango.config.ts --models ./src/models.ts --name add_posts
+tango migrate --config ./tango.config.ts
+tango plan --config ./tango.config.ts
+tango status --config ./tango.config.ts
 ```
 
-The top-level `new` command is also available as `codegen new`. Both paths exist so that the first-run project bootstrap workflow feels straightforward while still fitting into the broader command-module structure.
+Projects scaffolded through `tango new` use Tango's transparent runtime and `Model.objects` by default, so the generated application code stays focused on models, resources, and host-framework wiring.
 
 ## Using the package programmatically
 
@@ -41,39 +35,27 @@ The root export is intentionally small. If you need to embed Tango's CLI into a
 
 ```ts
 import type { Argv } from 'yargs';
-import {
-  createDefaultCommandModules,
-  runCli,
-  type TangoCliCommandModule,
-} from '@danceroutine/tango-cli';
+import { createDefaultCommandModules, runCli, type TangoCliCommandModule } from '@danceroutine/tango-cli';
 
 class AppCommandModule implements TangoCliCommandModule {
-  readonly id = 'app';
-
-  register(parser: Argv): Argv {
-    return parser.command(
-      'seed-demo-data',
-      'Load demo data into the local database',
-      () => {},
-      async () => {},
-    );
-  }
+    readonly id = 'app';
+
+    register(parser: Argv): Argv {
+        return parser.command(
+            'seed-demo-data',
+            'Load demo data into the local database',
+            () => {},
+            async () => {}
+        );
+    }
 }
 
 await runCli({
-  modules: [...createDefaultCommandModules(), new AppCommandModule()],
+    modules: [...createDefaultCommandModules(), new AppCommandModule()],
 });
 ```
 
-This approach keeps command composition modular. Tango's built-in modules remain intact, and your application can add its own command tree alongside them.
-
-## Documentation
-
-- Official documentation: https://danceroutine.github.io
-- CLI reference: https://danceroutine.github.io/reference/cli-api
-- Migrations topic: https://danceroutine.github.io/topics/migrations
-
-## Development
+## Developer workflow
 
 ```bash
 pnpm --filter @danceroutine/tango-cli build
@@ -81,9 +63,13 @@ pnpm --filter @danceroutine/tango-cli typecheck
 pnpm --filter @danceroutine/tango-cli test
 ```
 
-For the wider contributor workflow, use:
+## Bugs and support
 
-- https://danceroutine.github.io/contributing
+- Documentation: <https://tangowebframework.dev>
+- Config API: <https://tangowebframework.dev/reference/config-api>
+- CLI reference: <https://tangowebframework.dev/reference/cli-api>
+- Migrations topic: <https://tangowebframework.dev/topics/migrations>
+- Issue tracker: <https://github.com/danceroutine/tango/issues>
 
 ## License
 

package/bin/tango.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+try {
+    await import('../dist/cli.js');
+} catch {
+    console.error('The Tango CLI has not been built yet. Run `pnpm --filter @danceroutine/tango-cli build` first.');
+    process.exit(1);
+}

package/dist/domain/TangoCliCommandModule.d.ts

@@ -1,5 +1,14 @@
 import type { Argv } from 'yargs';
+/**
+ * Contract for modules that attach one command subtree to the shared Tango CLI.
+ */
 export interface TangoCliCommandModule {
+    /**
+     * Stable identifier used to describe the module within composed CLI setups.
+     */
     readonly id: string;
+    /**
+     * Register the module's commands on the shared yargs parser.
+     */
     register(parser: Argv): Argv;
 }

package/dist/runCli-Btn_GxD3.js.map

@@ -1 +1 @@
-{"version":3,"file":"runCli-Btn_GxD3.js","names":["parser: Argv","parser: Argv","options: RunCliOptions"],"sources":["../src/commands/CodegenCommandModule.ts","../src/commands/MigrationsCommandModule.ts","../src/commands/createDefaultCommandModules.ts","../src/runCli.ts"],"sourcesContent":["import type { Argv } from 'yargs';\nimport { registerCodegenCommands } from '@danceroutine/tango-codegen';\nimport type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\n\n/**\n * CLI module that mounts Tango's code-generation commands.\n */\nexport class CodegenCommandModule implements TangoCliCommandModule {\n    readonly id = 'codegen';\n\n    /**\n     * Register the code-generation command tree on the shared parser.\n     */\n    register(parser: Argv): Argv {\n        return registerCodegenCommands(parser);\n    }\n}\n","import type { Argv } from 'yargs';\nimport { registerMigrationsCommands } from '@danceroutine/tango-migrations';\nimport type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\n\n/**\n * CLI module that mounts Tango's migration commands.\n */\nexport class MigrationsCommandModule implements TangoCliCommandModule {\n    readonly id = 'migrations';\n\n    /**\n     * Register the migration command tree on the shared parser.\n     */\n    register(parser: Argv): Argv {\n        return registerMigrationsCommands(parser);\n    }\n}\n","import type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\nimport { CodegenCommandModule } from './CodegenCommandModule';\nimport { MigrationsCommandModule } from './MigrationsCommandModule';\n\n/**\n * Create the standard command modules shipped with Tango's CLI.\n */\nexport function createDefaultCommandModules(): readonly TangoCliCommandModule[] {\n    return [new MigrationsCommandModule(), new CodegenCommandModule()];\n}\n","import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport type { TangoCliCommandModule } from './domain/TangoCliCommandModule';\nimport { createDefaultCommandModules } from './commands/createDefaultCommandModules';\n\nexport type RunCliOptions = {\n    argv?: readonly string[];\n    modules?: readonly TangoCliCommandModule[];\n};\n\n/**\n * Run Tango's CLI with a supplied argv list and command module set.\n *\n * This is the entry point used by the binary, and it is also useful in tests\n * or host applications that want to customize which commands are available.\n */\nexport async function runCli(options: RunCliOptions = {}): Promise<void> {\n    const modules = options.modules ?? createDefaultCommandModules();\n    const argvInput = options.argv ?? hideBin(process.argv);\n\n    let parser = yargs([...argvInput]);\n    parser = parser.scriptName('tango');\n\n    for (const module of modules) {\n        parser = module.register(parser);\n    }\n\n    await parser\n        .demandCommand(1, 'You must specify a command')\n        .strict()\n        .exitProcess(false)\n        .help()\n        .alias('help', 'h')\n        .alias('version', 'v')\n        .parseAsync();\n}\n"],"mappings":";;;;;;IAOa,uBAAN,MAA4D;CAC/D,KAAc;;;;CAKd,SAASA,QAAoB;AACzB,SAAO,wBAAwB,OAAO;CACzC;AACJ;;;;ICTY,0BAAN,MAA+D;CAClE,KAAc;;;;CAKd,SAASC,QAAoB;AACzB,SAAO,2BAA2B,OAAO;CAC5C;AACJ;;;;ACTM,SAAS,8BAAgE;AAC5E,QAAO,CAAC,IAAI,2BAA2B,IAAI,sBAAuB;AACrE;;;;ACOM,eAAe,OAAOC,UAAyB,CAAE,GAAiB;CACrE,MAAM,UAAU,QAAQ,WAAW,6BAA6B;CAChE,MAAM,YAAY,QAAQ,QAAQ,QAAQ,QAAQ,KAAK;CAEvD,IAAI,SAAS,MAAM,CAAC,GAAG,SAAU,EAAC;AAClC,UAAS,OAAO,WAAW,QAAQ;AAEnC,MAAK,MAAM,UAAU,QACjB,UAAS,OAAO,SAAS,OAAO;AAGpC,OAAM,OACD,cAAc,GAAG,6BAA6B,CAC9C,QAAQ,CACR,YAAY,MAAM,CAClB,MAAM,CACN,MAAM,QAAQ,IAAI,CAClB,MAAM,WAAW,IAAI,CACrB,YAAY;AACpB"}
+{"version":3,"file":"runCli-Btn_GxD3.js","names":["parser: Argv","parser: Argv","options: RunCliOptions"],"sources":["../src/commands/CodegenCommandModule.ts","../src/commands/MigrationsCommandModule.ts","../src/commands/createDefaultCommandModules.ts","../src/runCli.ts"],"sourcesContent":["import type { Argv } from 'yargs';\nimport { registerCodegenCommands } from '@danceroutine/tango-codegen';\nimport type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\n\n/**\n * CLI module that mounts Tango's code-generation commands.\n */\nexport class CodegenCommandModule implements TangoCliCommandModule {\n    readonly id = 'codegen';\n\n    /**\n     * Register the code-generation command tree on the shared parser.\n     */\n    register(parser: Argv): Argv {\n        return registerCodegenCommands(parser);\n    }\n}\n","import type { Argv } from 'yargs';\nimport { registerMigrationsCommands } from '@danceroutine/tango-migrations';\nimport type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\n\n/**\n * CLI module that mounts Tango's migration commands.\n */\nexport class MigrationsCommandModule implements TangoCliCommandModule {\n    readonly id = 'migrations';\n\n    /**\n     * Register the migration command tree on the shared parser.\n     */\n    register(parser: Argv): Argv {\n        return registerMigrationsCommands(parser);\n    }\n}\n","import type { TangoCliCommandModule } from '../domain/TangoCliCommandModule';\nimport { CodegenCommandModule } from './CodegenCommandModule';\nimport { MigrationsCommandModule } from './MigrationsCommandModule';\n\n/**\n * Create the standard command modules shipped with Tango's CLI.\n */\nexport function createDefaultCommandModules(): readonly TangoCliCommandModule[] {\n    return [new MigrationsCommandModule(), new CodegenCommandModule()];\n}\n","import yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport type { TangoCliCommandModule } from './domain/TangoCliCommandModule';\nimport { createDefaultCommandModules } from './commands/createDefaultCommandModules';\n\nexport type RunCliOptions = {\n    /**\n     * Argument vector to parse. When omitted, the current process argv is used.\n     */\n    argv?: readonly string[];\n\n    /**\n     * Command modules to register before parsing. The built-in set is used by default.\n     */\n    modules?: readonly TangoCliCommandModule[];\n};\n\n/**\n * Run Tango's CLI with a supplied argv list and command module set.\n *\n * This is the entry point used by the binary, and it is also useful in tests\n * or host applications that want to customize which commands are available.\n */\nexport async function runCli(options: RunCliOptions = {}): Promise<void> {\n    const modules = options.modules ?? createDefaultCommandModules();\n    const argvInput = options.argv ?? hideBin(process.argv);\n\n    let parser = yargs([...argvInput]);\n    parser = parser.scriptName('tango');\n\n    for (const module of modules) {\n        parser = module.register(parser);\n    }\n\n    await parser\n        .demandCommand(1, 'You must specify a command')\n        .strict()\n        .exitProcess(false)\n        .help()\n        .alias('help', 'h')\n        .alias('version', 'v')\n        .parseAsync();\n}\n"],"mappings":";;;;;;IAOa,uBAAN,MAA4D;CAC/D,KAAc;;;;CAKd,SAASA,QAAoB;AACzB,SAAO,wBAAwB,OAAO;CACzC;AACJ;;;;ICTY,0BAAN,MAA+D;CAClE,KAAc;;;;CAKd,SAASC,QAAoB;AACzB,SAAO,2BAA2B,OAAO;CAC5C;AACJ;;;;ACTM,SAAS,8BAAgE;AAC5E,QAAO,CAAC,IAAI,2BAA2B,IAAI,sBAAuB;AACrE;;;;ACcM,eAAe,OAAOC,UAAyB,CAAE,GAAiB;CACrE,MAAM,UAAU,QAAQ,WAAW,6BAA6B;CAChE,MAAM,YAAY,QAAQ,QAAQ,QAAQ,QAAQ,KAAK;CAEvD,IAAI,SAAS,MAAM,CAAC,GAAG,SAAU,EAAC;AAClC,UAAS,OAAO,WAAW,QAAQ;AAEnC,MAAK,MAAM,UAAU,QACjB,UAAS,OAAO,SAAS,OAAO;AAGpC,OAAM,OACD,cAAc,GAAG,6BAA6B,CAC9C,QAAQ,CACR,YAAY,MAAM,CAClB,MAAM,CACN,MAAM,QAAQ,IAAI,CAClB,MAAM,WAAW,IAAI,CACrB,YAAY;AACpB"}

package/dist/runCli.d.ts

@@ -1,6 +1,12 @@
 import type { TangoCliCommandModule } from './domain/TangoCliCommandModule';
 export type RunCliOptions = {
+    /**
+     * Argument vector to parse. When omitted, the current process argv is used.
+     */
     argv?: readonly string[];
+    /**
+     * Command modules to register before parsing. The built-in set is used by default.
+     */
     modules?: readonly TangoCliCommandModule[];
 };
 /**

package/package.json

@@ -1,51 +1,54 @@
 {
-    "name": "@danceroutine/tango-cli",
-    "version": "0.1.0",
-    "description": "Unified Tango command line interface for migrations and code generation",
-    "type": "module",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "bin": {
-        "tango": "dist/cli.js"
-    },
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsdown",
-        "test": "vitest run --coverage",
-        "test:watch": "vitest",
-        "typecheck": "tsc --noEmit"
-    },
-    "keywords": [
-        "tango",
-        "cli",
-        "migrations",
-        "codegen"
-    ],
-    "author": "Pedro Del Moral Lopez",
-    "license": "MIT",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/danceroutine/tango.git",
-        "directory": "packages/cli"
-    },
-    "dependencies": {
-        "@danceroutine/tango-codegen": "workspace:*",
-        "@danceroutine/tango-migrations": "workspace:*",
-        "yargs": "^17.7.2"
-    },
-    "devDependencies": {
-        "@types/node": "^22.9.0",
-        "@types/yargs": "^17.0.33",
-        "tsdown": "^0.4.0",
-        "typescript": "^5.6.3",
-        "vitest": "^4.0.6"
+  "name": "@danceroutine/tango-cli",
+  "version": "1.0.0",
+  "description": "Unified Tango command line interface for migrations and code generation",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "tango": "bin/tango.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
-}
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "keywords": [
+    "tango",
+    "cli",
+    "migrations",
+    "codegen"
+  ],
+  "author": "Pedro Del Moral Lopez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danceroutine/tango.git",
+    "directory": "packages/cli"
+  },
+  "dependencies": {
+    "yargs": "^17.7.2",
+    "@danceroutine/tango-codegen": "1.0.0",
+    "@danceroutine/tango-migrations": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "@types/yargs": "^17.0.33",
+    "tsdown": "^0.4.0",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.6"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "pnpm run typecheck:prod && pnpm run typecheck:test",
+    "typecheck:prod": "tsc --noEmit -p tsconfig.json",
+    "typecheck:test": "tsc --noEmit -p tsconfig.tests.json"
+  }
+}