@jml6m/skeletor 0.1.0-alpha.5 → 0.1.0-alpha.6

package/README.md

@@ -29,7 +29,7 @@ We use `@clack/prompts` for a modern experience:
 - Confirmation step
 - Proper cancel handling and nice spinners/intro/outro
 
-`--auto` stays fully non-interactive for scripts (requires `--template`; uses default owner/description).
+`--auto` stays fully non-interactive for scripts (requires `--template`). Pass `--owner` / `--description` on the CLI when scaffolding non-interactively.
 
 ## Pushing to GitHub
 
@@ -50,11 +50,12 @@ node src/index.js new my-project
 node src/index.js new my-api --template typescript
 
 # Non-interactive (scripts)
-npx @jml6m/skeletor new my-service --auto --template go
+npx @jml6m/skeletor new my-service --auto --template go --owner jml6m --description "My service"
 ```
 
 Common flags:
 - `--template <id>` (javascript, typescript, python, go, rust, java, csharp, ...)
+- `--owner <user>` / `--description <text>` (for `--auto`, or as interactive defaults)
 - `--auto` (skip all prompts; requires `--template`)
 - `--no-git` (skip git init; git is on by default)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jml6m/skeletor",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.6",
   "description": "Efficient scaffolding for custom development. Generates projects wired with personal lint/format/health/release/alias/AGENTS.md conventions.",
   "main": "src/index.js",
   "type": "module",
@@ -10,7 +10,20 @@
   "scripts": {
     "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
     "test:watch": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --watch",
-    "prepublishOnly": "npm test"
+    "lint": "npm run lint:encoding",
+    "lint:encoding": "node scripts/check-encoding.mjs",
+    "audit:ci": "node scripts/audit-ci.mjs",
+    "npm:reinstall": "node scripts/reinstall.mjs",
+    "git:pull": "node scripts/git-pull-all.mjs",
+    "release:patch": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags",
+    "release:alpha": "npm version prerelease --preid=alpha && git push --follow-tags",
+    "publish:dry": "npm publish --dry-run",
+    "prepublishOnly": "npm run lint && npm run audit:ci && npm test"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "repository": {
     "type": "git",

package/src/index.js

@@ -26,14 +26,16 @@ Usage:
 Options:
   --template <name>     Stack to scaffold (javascript, typescript, python, go, …)
                         Omit for an interactive language/stack picker (TTY required)
-  --auto                Non-interactive; requires --template (uses defaults — edit
-                        owner/description in generated files afterward)
+  --owner <user>        GitHub owner/org (default: jml6m; used with --auto or as
+                        interactive defaults)
+  --description <text>  Project description (default: generic skeletor blurb)
+  --auto                Non-interactive; requires --template
   --no-git              Skip git init (git is initialized by default)
 
 Examples:
   skeletor new my-api                    # interactive: pick stack, owner, description
   skeletor new my-api --template typescript
-  skeletor new my-lib --auto --template go
+  skeletor new my-lib --auto --template go --owner jml6m --description "My CLI tool"
   skeletor new my-lib --auto --template go --no-git
 `;
 
@@ -47,6 +49,8 @@ function parseArgs(argv) {
     command: null,
     name: null,
     template: null, // resolved later, can be interactive
+    owner: null,
+    description: null,
     auto: false,
     git: true,
   };
@@ -62,6 +66,8 @@ function parseArgs(argv) {
     for (let i = 2; i < args.length; i++) {
       const a = args[i];
       if (a === '--template' || a === '-t') result.template = args[++i] || null;
+      else if (a === '--owner' || a === '-o') result.owner = args[++i] || null;
+      else if (a === '--description' || a === '-d') result.description = args[++i] || null;
       else if (a === '--auto') result.auto = true;
       else if (a === '--no-git') result.git = false;
       else if (!a.startsWith('-') && !result.name) result.name = a;
@@ -101,6 +107,7 @@ function buildRenderVars({ name, owner, description }) {
     NAMESPACE: namespace,
     GROUP_ID: `io.github.${ownerSegment}`,
     GO_MODULE: `github.com/${repoOwner}/${name}`,
+    REPO_URL: `https://github.com/${repoOwner}/${name}`,
   };
 }
 
@@ -209,8 +216,8 @@ async function runNew(opts) {
   }
 
   let chosenTemplateId = opts.template;
-  let finalOwner = DEFAULT_OWNER;
-  let finalDesc = DEFAULT_DESCRIPTION;
+  let finalOwner = opts.owner || DEFAULT_OWNER;
+  let finalDesc = opts.description || DEFAULT_DESCRIPTION;
 
   const isInteractive = !auto && process.stdout.isTTY;
 
@@ -293,12 +300,17 @@ async function runNew(opts) {
 
   p.outro('✅ Done!');
 
-  console.log(`   cd ${name}`);
-  const suggested = templateInfo.verifyCommands && templateInfo.verifyCommands.length
-    ? templateInfo.verifyCommands[0]
-    : 'Run your language-specific install + test commands';
-  console.log(`   ${suggested}`);
-  console.log('   Then run the other steps from the template manifest (lint, test, etc.)');
+  printPostScaffoldSteps(name, templateInfo.verifyCommands);
+}
+
+/** Print cd + full verifyCommands list after scaffolding. */
+function printPostScaffoldSteps(projectName, verifyCommands) {
+  console.log(`   cd ${projectName}`);
+  const steps = Array.isArray(verifyCommands) && verifyCommands.length
+    ? verifyCommands
+    : ['Run your language-specific install + test commands'];
+  console.log('   Next steps:');
+  steps.forEach((cmd) => console.log(`     ${cmd}`));
   console.log('\n   Edit AGENTS.md (or equivalent) to customize the AI contract.');
   console.log('   Happy scaffolding. Your rules, your choice of stack.\n');
 }
@@ -338,6 +350,7 @@ export {
   ensureDir,
   copyAndRender,
   runNew,
+  printPostScaffoldSteps,
   USAGE,
 };
 

package/templates/csharp/.gitignore.tmpl

@@ -0,0 +1,16 @@
+bin/
+obj/
+*.user
+*.suo
+*.userosscache
+*.sln.docstates
+
+# Env
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

package/templates/csharp/Project.csproj.tmpl

@@ -1,17 +1,17 @@
-<Project Sdk="Microsoft.NET.Sdk">
-
-  <PropertyGroup>
-    <OutputType>Exe</OutputType>
-    <TargetFramework>net8.0</TargetFramework>
-    <ImplicitUsings>enable</ImplicitUsings>
-    <Nullable>enable</Nullable>
-    <RootNamespace>{{NAMESPACE}}</RootNamespace>
-  </PropertyGroup>
-
-  <ItemGroup>
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
-    <PackageReference Include="xunit" Version="2.6.6" />
-    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.6" />
-  </ItemGroup>
-
-</Project>
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <RootNamespace>{{NAMESPACE}}</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
+    <PackageReference Include="xunit" Version="2.6.6" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.6" />
+  </ItemGroup>
+
+</Project>

package/templates/go/.gitignore.tmpl

@@ -0,0 +1,24 @@
+# Binaries
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+{{PROJECT_NAME}}
+
+# Test binary
+*.test
+
+# Output
+bin/
+dist/
+
+# Env
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

package/templates/java/.gitignore.tmpl

@@ -0,0 +1,16 @@
+target/
+*.class
+*.jar
+*.war
+*.ear
+hs_err_pid*
+
+# Env
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

package/templates/javascript/.gitignore.tmpl

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# Build / output
+dist/
+build/
+coverage/
+report/
+reports/
+
+# Env & secrets
+.env
+.env.*
+*.local
+
+# Logs
+*.log
+logs/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.swp
+
+# Lockfiles that may be noisy in some flows (keep package-lock.json in real projects)
+# package-lock.json
+
+# Generated context for AI
+prompt.md

package/templates/python/.gitignore.tmpl

@@ -0,0 +1,27 @@
+# Bytecode / cache
+__pycache__/
+*.py[cod]
+*.pyo
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Build / packaging
+dist/
+build/
+*.egg-info/
+
+# Env & secrets
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

package/templates/rust/.gitignore.tmpl

@@ -0,0 +1,14 @@
+/target/
+**/*.rs.bk
+*.pdb
+Cargo.lock
+
+# Env
+.env
+.env.*
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/

package/templates/rust/Cargo.toml.tmpl

@@ -3,6 +3,7 @@ name = "{{PROJECT_NAME}}"
 version = "0.1.0"
 edition = "2021"
 description = "{{DESCRIPTION}}"
+repository = "{{REPO_URL}}"
 
 [dependencies]
 

package/templates/typescript/.gitignore.tmpl

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# Build / output
+dist/
+build/
+coverage/
+report/
+reports/
+
+# Env & secrets
+.env
+.env.*
+*.local
+
+# Logs
+*.log
+logs/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.swp
+
+# Lockfiles that may be noisy in some flows (keep package-lock.json in real projects)
+# package-lock.json
+
+# Generated context for AI
+prompt.md