theslopmachine 0.3.0 → 0.3.2

package/MANUAL.md

@@ -1,22 +1,22 @@
-# SlopMachine Manual
+# theslopmachine manual
 
 ## What it is
 
-SlopMachine installs a workflow-owner agent, a developer agent, and the supporting skills/templates needed to run the delivery workflow inside OpenCode.
+theslopmachine installs a workflow-owner agent, a developer agent, and the supporting skills/templates needed to run the delivery workflow inside OpenCode.
 
 ## Install
 
 Run:
 
 ```bash
-slopmachine install
+slopmachine setup
 ```
 
 This installs:
 
 - agents into `~/.config/opencode/agents/`
 - skills into `~/.agents/skills/`
-- SlopMachine-owned files into `~/slopmachine/`
+- theslopmachine-owned files into `~/slopmachine/`
 - merged plugin/MCP config into `~/.config/opencode/opencode.json`
 
 ## Start a project
@@ -58,6 +58,6 @@ slopmachine init -o
 
 ## Important notes
 
-- SlopMachine depends on OpenCode, Beads, git, python3, and Docker being available.
+- theslopmachine depends on OpenCode, Beads, git, python3, and Docker being available.
 - The workflow-owner agent uses mandatory skills for specific phases; skipping them is considered a workflow failure.
 - Submission packaging collects the final docs, reports, screenshots, session export, trajectory, and cleaned repo into the required final structure.

package/README.md

@@ -1,10 +1,10 @@
-# SlopMachine 0.3
+# theslopmachine 0.3
 
-Installer package for the SlopMachine workflow owner, developer agent, required skills, templates, and local support files.
+Installer package for the theslopmachine workflow owner, developer agent, required skills, templates, and local support files.
 
 ## Planned commands
 
-- `slopmachine install`
+- `slopmachine setup`
 - `slopmachine init`
 - `slopmachine init -o` to bootstrap the project and immediately open OpenCode inside `repo/`
 
@@ -20,4 +20,4 @@ See `MANUAL.md` for a short usage guide and workflow summary.
 
 ## Status
 
-This package workspace is being built from the current local SlopMachine v3 setup without modifying the live installation on this machine.
+This package workspace is being built from the current local theslopmachine setup without modifying the live installation on this machine.

package/RELEASE.md

@@ -11,7 +11,7 @@ node ./bin/slopmachine.js --help
 2. Test install into an isolated fake home:
 
 ```bash
-SLOPMACHINE_HOME="$(pwd)/.tmp-home" SLOPMACHINE_NONINTERACTIVE=1 SLOPMACHINE_PLUGIN_BOOTSTRAP=0 node ./bin/slopmachine.js install
+SLOPMACHINE_HOME="$(pwd)/.tmp-home" SLOPMACHINE_NONINTERACTIVE=1 SLOPMACHINE_PLUGIN_BOOTSTRAP=0 node ./bin/slopmachine.js setup
 ```
 
 3. Test init into an isolated temp project:
@@ -41,13 +41,13 @@ npm pack
 This should produce a tarball such as:
 
 ```bash
-slopmachine-0.3.0.tgz
+theslopmachine-0.3.0.tgz
 ```
 
 ## Inspect package contents
 
 ```bash
-tar -tzf slopmachine-0.3.0.tgz
+tar -tzf theslopmachine-0.3.0.tgz
 ```
 
 Check that the tarball includes:
@@ -77,5 +77,5 @@ npm publish --dry-run
 ## Versioning
 
 - bump `package.json` version before each release
-- keep the visual product name as `SlopMachine`
+- keep the CLI command as `slopmachine`
 - keep the npm package name as `slopmachine`

package/package.json

@@ -1,25 +1,25 @@
 {
-  "name": "theslopmachine",
-  "version": "0.3.0",
-  "description": "SlopMachine installer and project bootstrap CLI",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "slopmachine": "bin/slopmachine.js"
-  },
-  "scripts": {
-    "start": "node ./bin/slopmachine.js",
-    "check": "node ./bin/slopmachine.js --help"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "bin",
-    "src",
-    "assets",
-    "README.md",
-    "RELEASE.md",
-    "MANUAL.md"
-  ]
+    "name": "theslopmachine",
+    "version": "0.3.2",
+    "description": "SlopMachine installer and project bootstrap CLI",
+    "license": "MIT",
+    "type": "module",
+    "bin": {
+        "slopmachine": "bin/slopmachine.js"
+    },
+    "scripts": {
+        "start": "node ./bin/slopmachine.js",
+        "check": "node ./bin/slopmachine.js --help"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "files": [
+        "bin",
+        "src",
+        "assets",
+        "README.md",
+        "RELEASE.md",
+        "MANUAL.md"
+    ]
 }

package/src/cli.js

@@ -2,10 +2,10 @@ import { runInit } from './init.js'
 import { runInstall } from './install.js'
 
 function printHelp() {
-  console.log(`SlopMachine 0.3
+  console.log(`theslopmachine 0.3
 
 Commands:
-  install   Install SlopMachine into the local user environment
+  setup     Configure theslopmachine in the local user environment
   init      Run the packaged init script in the current directory (-o opens OpenCode in repo/)
   help      Show this help text`)
 }
@@ -18,7 +18,7 @@ export async function runCli(args) {
     return
   }
 
-  if (command === 'install') {
+  if (command === 'setup' || command === 'install') {
     await runInstall()
     return
   }

package/src/init.js

@@ -2,7 +2,7 @@ import fs from 'node:fs/promises'
 import path from 'node:path'
 
 import { buildPaths } from './constants.js'
-import { ensureDir, log, pathExists, runCommand } from './utils.js'
+import { commandExists, ensureDir, log, pathExists, runCommand, warn } from './utils.js'
 
 const GITIGNORE_ENTRIES = [
   '.DS_Store',
@@ -46,11 +46,11 @@ async function assertRequiredFiles(paths) {
   const agentsTemplate = path.join(paths.slopmachineDir, 'templates', 'AGENTS.md')
 
   if (!(await pathExists(beadsScript))) {
-    throw new Error(`Missing packaged Beads init script at ${beadsScript}. Run slopmachine install first.`)
+    throw new Error(`Missing packaged Beads init script at ${beadsScript}. Run slopmachine setup first.`)
   }
 
   if (!(await pathExists(agentsTemplate))) {
-    throw new Error(`Missing packaged AGENTS template at ${agentsTemplate}. Run slopmachine install first.`)
+    throw new Error(`Missing packaged AGENTS template at ${agentsTemplate}. Run slopmachine setup first.`)
   }
 
   return { beadsScript, agentsTemplate }
@@ -145,6 +145,11 @@ async function maybeOpenOpencode(targetPath, openAfterInit) {
     return
   }
 
+  if (!(await commandExists('opencode'))) {
+    warn('OpenCode is not available in PATH, so the project was initialized but could not be opened automatically. Launch OpenCode manually inside repo/.')
+    return
+  }
+
   log('Opening OpenCode in repo/')
   const result = await runCommand('opencode', [], {
     stdio: 'inherit',

package/src/install.js

@@ -39,6 +39,27 @@ async function getCommandVersion(command, args = ['--version']) {
   return (result.stdout || result.stderr).trim()
 }
 
+async function getPythonVersion() {
+  const python3Version = await getCommandVersion('python3')
+  if (python3Version) {
+    return { command: 'python3', version: python3Version }
+  }
+
+  const pythonVersion = await getCommandVersion('python')
+  if (pythonVersion) {
+    return { command: 'python', version: pythonVersion }
+  }
+
+  if (process.platform === 'win32' && await commandExists('py')) {
+    const result = await runCommand('py', ['-3', '--version'])
+    if (result.code === 0) {
+      return { command: 'py -3', version: (result.stdout || result.stderr).trim() }
+    }
+  }
+
+  return null
+}
+
 async function detectPackageManagers() {
   return {
     brew: await commandExists('brew'),
@@ -102,6 +123,17 @@ async function tryInstallCoreDependency(name) {
 }
 
 async function ensureDependency({ name, checkCommand, requiredVersion, installable }) {
+  if (name === 'python3') {
+    const python = await getPythonVersion()
+    if (python) {
+      log(`${name} detected via ${python.command}: ${python.version}`)
+      if (requiredVersion && !python.version.includes(requiredVersion)) {
+        warn(`${name} version differs from tested reference ${requiredVersion}`)
+      }
+      return
+    }
+  }
+
   const version = await getCommandVersion(checkCommand)
   if (version) {
     log(`${name} detected: ${version}`)
@@ -119,7 +151,7 @@ async function ensureDependency({ name, checkCommand, requiredVersion, installab
 
   const shouldInstall = await promptYesNo(`Attempt to install ${name} automatically?`, true)
   if (!shouldInstall) {
-    warn(`Skipping ${name} installation. Please install it manually before using SlopMachine.`)
+      warn(`Skipping ${name} installation. Please install it manually before using theslopmachine.`)
     return
   }
 
@@ -133,7 +165,7 @@ async function checkDocker() {
   const dockerVersion = await getCommandVersion('docker')
   const composeVersion = await getCommandVersion('docker', ['compose', 'version'])
   if (!dockerVersion || !composeVersion) {
-    warn('Docker and Docker Compose are required for SlopMachine workflows. Please install Docker Desktop or the Docker Engine + Compose plugin and start Docker.')
+    warn('Docker and Docker Compose are required for theslopmachine workflows. Please install Docker Desktop or the Docker Engine + Compose plugin and start Docker.')
     return
   }
   log(`docker detected: ${dockerVersion}`)
@@ -141,7 +173,7 @@ async function checkDocker() {
 
   const info = await runCommand('docker', ['info'])
   if (info.code !== 0) {
-    warn('Docker is installed but does not appear to be running. Start Docker before using SlopMachine.')
+    warn('Docker is installed but does not appear to be running. Start Docker before using theslopmachine.')
   }
 }
 
@@ -294,7 +326,7 @@ async function collectApiKeys() {
 
 export async function runInstall() {
   const paths = buildPaths()
-  log(`Installing SlopMachine into ${paths.home}`)
+  log(`Configuring theslopmachine in ${paths.home}`)
 
   await ensureDependency({ name: 'git', checkCommand: 'git', installable: true })
   await ensureDependency({ name: 'python3', checkCommand: 'python3', installable: true })
@@ -311,8 +343,8 @@ export async function runInstall() {
   const keys = await collectApiKeys()
   await mergeOpencodeConfig(paths, keys)
 
-  log('Installation phase completed.')
-  console.log('\nSlopMachine install summary')
+  log('Setup phase completed.')
+  console.log('\ntheslopmachine setup summary')
   console.log(`- Agents installed: ${agentSummary.installed.length}`)
   console.log(`- Agents skipped: ${agentSummary.skipped.length}`)
   console.log(`- Skills installed: ${skillSummary.installed.length}`)
@@ -325,6 +357,6 @@ export async function runInstall() {
   console.log(`- OpenCode config: ${paths.opencodeConfigPath}`)
   console.log('\nNext steps')
   console.log('- Review any warnings above for skipped files or missing external dependencies.')
-  console.log('- If Docker was reported as stopped, start Docker before using SlopMachine on a real project.')
-  console.log('- Run `slopmachine init` inside a project directory to bootstrap a new SlopMachine workspace.')
+  console.log('- If Docker was reported as stopped, start Docker before using theslopmachine on a real project.')
+  console.log('- Run `slopmachine init` inside a project directory to bootstrap a new theslopmachine workspace.')
 }