stet-cli 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.3 — 2026-11-14
+- Stack detection now finds projects in subfolders (e.g. backend/, frontend/, apps/web) and languages from file types, so monorepos with Python + JavaScript are detected correctly.
+- stet init creates one test lock per sub-project (e.g. `cd backend && pytest -q`).
+
 ## 0.1.2 — 2026-11-13
 - Published on npm as stet-cli (the command is still `stet`).
 

package/lib/core.js

@@ -77,37 +77,83 @@ function matches(file, globs) {
 const splitList = (v) => (Array.isArray(v) ? v : String(v || '').split(',')).map((s) => s.trim()).filter(Boolean);
 
 // ---------- stack detection ----------
-function detect(root) {
-  const ex = (f) => fs.existsSync(path.join(root, f));
-  const rd = (f) => { try { return fs.readFileSync(path.join(root, f), 'utf8'); } catch { return ''; } };
-  const s = { langs: [], frameworks: [], test: null, run: [], deps: [], entry: [] };
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', '.next', 'out', 'coverage', '__pycache__', '.venv', 'venv', 'env', 'vendor', 'target', '.stet', '.idea', '.vscode']);
+const MANIFESTS = ['package.json', 'pyproject.toml', 'requirements.txt', 'setup.py', 'Pipfile', 'go.mod', 'Cargo.toml', 'Gemfile', 'pom.xml', 'build.gradle', 'composer.json', 'pubspec.yaml'];
+const EXT_LANG = { py: 'Python', ts: 'TypeScript', tsx: 'TypeScript', js: 'JavaScript', jsx: 'JavaScript', go: 'Go', rs: 'Rust', rb: 'Ruby', java: 'Java', kt: 'Kotlin', swift: 'Swift', php: 'PHP', cs: 'C#', dart: 'Dart' };
+
+// Folders (root + up to 2 levels deep) that contain a project manifest, e.g. "", "backend", "apps/web".
+function projectDirs(root) {
+  const out = [];
+  const walk = (rel, depth) => {
+    const abs = path.join(root, rel);
+    let entries = [];
+    try { entries = fs.readdirSync(abs, { withFileTypes: true }); } catch { return; }
+    if (entries.some((e) => e.isFile() && MANIFESTS.includes(e.name))) out.push(rel);
+    if (depth >= 2) return;
+    for (const e of entries) if (e.isDirectory() && !SKIP_DIRS.has(e.name) && !e.name.startsWith('.')) walk(rel ? rel + '/' + e.name : e.name, depth + 1);
+  };
+  walk('', 0);
+  return out;
+}
+
+function detectIn(root, rel, s) {
+  const ex = (f) => fs.existsSync(path.join(root, rel, f));
+  const rd = (f) => { try { return fs.readFileSync(path.join(root, rel, f), 'utf8'); } catch { return ''; } };
+  const where = rel ? ` (${rel}/)` : '';
+  const cd = (cmd) => (rel ? `cd ${rel} && ${cmd}` : cmd);
+  const addLang = (l) => { if (!s.langs.includes(l + where)) s.langs.push(l + where); };
+  const addFw = (f) => { if (!s.frameworks.includes(f)) s.frameworks.push(f); };
+  const addTest = (cmd) => { if (!s.tests.includes(cd(cmd))) s.tests.push(cd(cmd)); };
+  const p = (f) => (rel ? rel + '/' + f : f);
   if (ex('package.json')) {
     let pj = {}; try { pj = JSON.parse(rd('package.json')); } catch {}
     const deps = { ...(pj.dependencies || {}), ...(pj.devDependencies || {}) };
     s.deps.push(...Object.keys(pj.dependencies || {}));
-    s.langs.push(deps.typescript || ex('tsconfig.json') ? 'TypeScript' : 'JavaScript');
-    for (const [k, n] of [['next', 'Next.js'], ['react', 'React'], ['vue', 'Vue'], ['svelte', 'Svelte'], ['express', 'Express'], ['@nestjs/core', 'NestJS'], ['fastify', 'Fastify'], ['hono', 'Hono'], ['vite', 'Vite'], ['prisma', 'Prisma'], ['drizzle-orm', 'Drizzle'], ['@supabase/supabase-js', 'Supabase'], ['stripe', 'Stripe'], ['tailwindcss', 'Tailwind']]) if (deps[k]) s.frameworks.push(n);
-    const pm = ex('pnpm-lock.yaml') ? 'pnpm' : ex('yarn.lock') ? 'yarn' : ex('bun.lockb') || ex('bun.lock') ? 'bun' : 'npm';
+    const emptyWorkspaceRoot = !rel && !Object.keys(deps).length && !Object.keys(pj.scripts || {}).length;
+    if (!emptyWorkspaceRoot) addLang(deps.typescript || ex('tsconfig.json') ? 'TypeScript' : 'JavaScript');
+    for (const [k, n] of [['next', 'Next.js'], ['react', 'React'], ['vue', 'Vue'], ['svelte', 'Svelte'], ['express', 'Express'], ['@nestjs/core', 'NestJS'], ['fastify', 'Fastify'], ['hono', 'Hono'], ['vite', 'Vite'], ['prisma', 'Prisma'], ['drizzle-orm', 'Drizzle'], ['@supabase/supabase-js', 'Supabase'], ['stripe', 'Stripe'], ['tailwindcss', 'Tailwind']]) if (deps[k]) addFw(n);
+    const rootEx = (f) => ex(f) || fs.existsSync(path.join(root, f));
+    const pm = rootEx('pnpm-lock.yaml') ? 'pnpm' : rootEx('yarn.lock') ? 'yarn' : rootEx('bun.lockb') || rootEx('bun.lock') ? 'bun' : 'npm';
     const sc = pj.scripts || {};
-    if (sc.test && !/no test specified/.test(sc.test)) s.test = `${pm} test`;
-    for (const k of ['dev', 'start', 'build', 'lint', 'typecheck']) if (sc[k]) s.run.push(`${pm} run ${k}`);
-    if (pj.main) s.entry.push(pj.main);
-    if (pj.bin) s.entry.push(...(typeof pj.bin === 'string' ? [pj.bin] : Object.values(pj.bin)));
+    if (sc.test && !/no test specified/.test(sc.test)) addTest(`${pm} test`);
+    for (const k of ['dev', 'start', 'build', 'lint', 'typecheck']) if (sc[k]) s.run.push(cd(`${pm} run ${k}`));
+    if (pj.main) s.entry.push(p(pj.main));
+    if (pj.bin) s.entry.push(...(typeof pj.bin === 'string' ? [pj.bin] : Object.values(pj.bin)).map(p));
   }
-  if (ex('pyproject.toml') || ex('requirements.txt') || ex('setup.py')) {
-    s.langs.push('Python');
-    const txt = (rd('pyproject.toml') + '\n' + rd('requirements.txt')).toLowerCase();
-    for (const [k, n] of [['django', 'Django'], ['fastapi', 'FastAPI'], ['flask', 'Flask'], ['sqlalchemy', 'SQLAlchemy'], ['pydantic', 'Pydantic'], ['pandas', 'pandas'], ['celery', 'Celery']]) if (txt.includes(k)) s.frameworks.push(n);
-    s.deps.push(...nonEmpty(rd('requirements.txt')).filter((l) => !l.startsWith('#')).map((l) => l.split(/[=<>~! ;\[]/)[0]));
-    if (!s.test && (ex('tests') || ex('pytest.ini') || txt.includes('pytest'))) s.test = 'pytest -q';
-    if (ex('manage.py')) { s.run.push('python manage.py runserver'); s.entry.push('manage.py'); }
+  if (ex('pyproject.toml') || ex('requirements.txt') || ex('setup.py') || ex('Pipfile')) {
+    addLang('Python');
+    const txt = (rd('pyproject.toml') + '\n' + rd('requirements.txt') + '\n' + rd('Pipfile')).toLowerCase();
+    for (const [k, n] of [['django', 'Django'], ['fastapi', 'FastAPI'], ['flask', 'Flask'], ['sqlalchemy', 'SQLAlchemy'], ['pydantic', 'Pydantic'], ['pandas', 'pandas'], ['celery', 'Celery']]) if (txt.includes(k)) addFw(n);
+    s.deps.push(...nonEmpty(rd('requirements.txt')).filter((l) => !l.trim().startsWith('#') && !l.trim().startsWith('-')).map((l) => l.trim().split(/[=<>~! ;\[]/)[0]));
+    if (ex('tests') || ex('test') || ex('pytest.ini') || ex('conftest.py') || txt.includes('[tool.pytest')) addTest('pytest -q');
+    if (ex('manage.py')) { s.run.push(cd('python manage.py runserver')); s.entry.push(p('manage.py')); }
+  }
+  if (ex('go.mod')) { addLang('Go'); addTest('go test ./...'); }
+  if (ex('Cargo.toml')) { addLang('Rust'); addTest('cargo test'); }
+  if (ex('Gemfile')) addLang('Ruby');
+  if (ex('pom.xml') || ex('build.gradle')) addLang('Java');
+  if (ex('composer.json')) addLang('PHP');
+  if (ex('pubspec.yaml')) addLang('Dart');
+  if (ex('Dockerfile') || ex('docker-compose.yml') || ex('docker-compose.yaml') || ex('compose.yaml')) addFw('Docker');
+  for (const f of ['main.py', 'app.py', 'server.js', 'index.js', 'src/server.js', 'src/server.ts', 'src/app.js', 'src/index.ts', 'src/main.ts', 'src/index.js', 'src/app.ts', 'app/main.py', 'app/page.tsx', 'src/main.tsx', 'main.go', 'src/main.rs']) if (ex(f) && !s.entry.includes(p(f))) s.entry.push(p(f));
+  if (!rel && ex('Makefile')) s.run.push(...nonEmpty(rd('Makefile')).filter((l) => /^[a-zA-Z][\w-]*:/.test(l)).slice(0, 6).map((l) => 'make ' + l.split(':')[0]));
+}
+
+function detect(root) {
+  const s = { langs: [], frameworks: [], tests: [], test: null, run: [], deps: [], entry: [] };
+  for (const rel of projectDirs(root)) detectIn(root, rel, s);
+  if (!s.frameworks.includes('Docker') && ['Dockerfile', 'docker-compose.yml', 'docker-compose.yaml', 'compose.yaml', 'compose.yml'].some((f) => fs.existsSync(path.join(root, f)))) s.frameworks.push('Docker');
+  // Fallback: languages with real source files but no manifest we recognise.
+  const files = names(tgit(['ls-files', '--cached', '--others', '--exclude-standard'], root));
+  const count = {};
+  for (const f of files) {
+    if (f.split('/').some((seg) => SKIP_DIRS.has(seg))) continue;
+    const l = EXT_LANG[f.split('.').pop().toLowerCase()];
+    if (l) count[l] = (count[l] || 0) + 1;
   }
-  if (ex('go.mod')) { s.langs.push('Go'); s.test = s.test || 'go test ./...'; }
-  if (ex('Cargo.toml')) { s.langs.push('Rust'); s.test = s.test || 'cargo test'; }
-  if (ex('Gemfile')) s.langs.push('Ruby');
-  if (ex('Dockerfile') || ex('docker-compose.yml') || ex('compose.yaml')) s.frameworks.push('Docker');
-  for (const f of ['main.py', 'app.py', 'server.js', 'index.js', 'src/server.js', 'src/server.ts', 'src/app.js', 'src/index.ts', 'src/main.ts', 'src/index.js', 'src/app.ts', 'app/page.tsx', 'src/main.tsx', 'main.go', 'src/main.rs']) if (ex(f) && !s.entry.includes(f)) s.entry.push(f);
-  if (ex('Makefile')) s.run.push(...nonEmpty(rd('Makefile')).filter((l) => /^[a-zA-Z][\w-]*:/.test(l)).slice(0, 6).map((l) => 'make ' + l.split(':')[0]));
+  for (const [l, n] of Object.entries(count)) if (n >= 3 && !s.langs.some((x) => x.split(' (')[0] === l)) s.langs.push(l);
+  s.deps = [...new Set(s.deps.filter(Boolean))];
+  s.test = s.tests.length ? s.tests.join(' && ') : null;
   return s;
 }
 
@@ -155,7 +201,7 @@ ${name} is ...
 
 ## Stack
 - ${stack}
-${st.test ? `- Tests: \`${st.test}\`\n` : ''}${st.run.length ? `- Run: ${st.run.map((x) => '`' + x + '`').join(', ')}\n` : ''}
+${st.tests.length ? `- Tests: ${st.tests.map((x) => '`' + x + '`').join(', ')}\n` : ''}${st.run.length ? `- Run: ${st.run.map((x) => '`' + x + '`').join(', ')}\n` : ''}
 ## Always
 - Read this charter, the current scope and the locked behaviours before changing code.
 - Make the smallest change that solves the task. Match the existing style and patterns.
@@ -253,7 +299,10 @@ function init(r, { name, mcp } = {}) {
   const put = (f, s) => { if (fs.existsSync(r.p(f))) kept.push(f); else { r.write(f, s); made.push(f); } };
   put('config.json', JSON.stringify({ name: nm, version: 1, protect: [], ignore: [], maxFileKB: 64, checkTimeoutSec: 600 }, null, 2) + '\n');
   put('charter.md', charterTemplate(nm, st));
-  put('locks.json', JSON.stringify(st.test ? [{ id: 'L1', name: 'Full test suite passes', cmd: st.test, protect: [], added: today() }] : [], null, 2) + '\n');
+  put('locks.json', JSON.stringify(st.tests.map((cmd, i) => {
+    const m = cmd.match(/^cd (\S+) && /);
+    return { id: 'L' + (i + 1), name: m ? `Test suite passes (${m[1]}/)` : 'Full test suite passes', cmd, protect: [], added: today() };
+  }), null, 2) + '\n');
   put('scope.json', '{}\n');
   put('decisions.md', `# Decision log — ${nm}\n\nOne entry per decision. Newest at the bottom. Managed with \`stet decide\`.\n\n## D-001 · ${today()} · Adopted Stet to keep AI agents in scope\nAI agents read AGENTS.md. Locked behaviours are checked with \`stet check\` before work is called done.\n`);
   put('.gitignore', '.cache/\ncontext.md\n');
@@ -495,7 +544,7 @@ Generated by Stet ${VERSION} on ${today()}. Regenerate any time with \`stet hand
 ${charter}
 
 ## 2. Run it
-${st.run.length || st.test ? [...st.run, ...(st.test ? [st.test + '   # tests'] : [])].map((x) => '- `' + x + '`').join('\n') : '- No run scripts detected. Add them to the charter.'}
+${st.run.length || st.tests.length ? [...st.run, ...st.tests.map((t) => t + '   # tests')].map((x) => '- `' + x + '`').join('\n') : '- No run scripts detected. Add them to the charter.'}
 ${envKeys.length ? `\nEnvironment variables needed (names only, from the example env file):\n${envKeys.map((k) => '`' + k + '`').join(' · ')}` : ''}
 
 ## 3. Architecture at a glance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stet-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Keep AI coding agents from breaking what already works. Charter, locked behaviours, scope guard, decision log and git-synced context for Claude Code, Cursor, Codex and any chat.",
   "bin": {
     "stet": "bin/stet.js"