@aipt/idp-cli 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# IDP Developer CLI
+
+`idp` 是开发者统一入口，不是第三套 Kernel。它用中文发现当前上下文，并将工程能力委托给 Dyyto、将交付和环境能力委托给 idp-deploy。
+
+```bash
+node bin/idp.mjs doctor
+node bin/idp.mjs app inspect --cwd /absolute/project
+node bin/idp.mjs capability catalog search
+node bin/idp.mjs delivery lifecycle check
+node bin/idp.mjs environment foundation doctor
+```
+
+开发、计划和渲染不要求 Kubernetes；具体部署动作是否需要环境资源，由 idp-deploy 合同判断。可用 `IDP_DYYTO_BIN` 和 `IDP_DEPLOY_BIN` 指向源码构建产物，默认也会发现 PATH 或同级源码仓库。
+
+## 验证
+
+```bash
+npm run check
+npm run example
+npm run example:clean
+```
+
+人工检查 `.examples/delegation` 的输出：doctor 应显示本地开发可进行，委托动作应保留完整 argv，且无需 Kubernetes。真实脚手架仍走 Dyyto 的 Catalog、Plan、Apply、Verifier，不由本仓库复制模板。

package/bin/idp.mjs

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+import { accessSync, constants, existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const spacesRoot = resolve(repoRoot, '..');
+
+function executable(path) {
+  try { accessSync(path, constants.X_OK); return true; } catch { return false; }
+}
+
+function commandOnPath(name) {
+  const result = spawnSync('which', [name], { encoding: 'utf8', shell: false });
+  return result.status === 0 ? result.stdout.trim() : null;
+}
+
+function discoverKernel(kind) {
+  const isDyyto = kind === 'dyyto';
+  const configured = process.env[isDyyto ? 'IDP_DYYTO_BIN' : 'IDP_DEPLOY_BIN'];
+  if (configured) return { command: process.execPath, prefix: [resolve(configured)], source: 'environment' };
+  const pathName = isDyyto ? 'dyyto' : 'idpctl';
+  const fromPath = commandOnPath(pathName);
+  if (fromPath) return { command: fromPath, prefix: [], source: 'path' };
+  const local = isDyyto
+    ? resolve(spacesRoot, 'dyyto/apps/cli/dist/cli.js')
+    : resolve(spacesRoot, 'idp-deploy/bin/idpctl.mjs');
+  if (existsSync(local)) return { command: process.execPath, prefix: [local], source: 'sibling' };
+  return null;
+}
+
+function parseGlobal(argv) {
+  let cwd = process.cwd();
+  let json = false;
+  const rest = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    if (argv[index] === '--cwd') {
+      if (!argv[index + 1]) throw new Error('--cwd 缺少目录参数');
+      cwd = resolve(argv[++index]);
+    } else if (argv[index] === '--json') { json = true; rest.push(argv[index]); }
+    else rest.push(argv[index]);
+  }
+  if (!existsSync(cwd)) throw new Error(`工作目录不存在：${cwd}`);
+  return { cwd, json, rest };
+}
+
+function run(kernelName, args, cwd) {
+  const kernel = discoverKernel(kernelName);
+  if (!kernel) {
+    const variable = kernelName === 'dyyto' ? 'IDP_DYYTO_BIN' : 'IDP_DEPLOY_BIN';
+    throw new Error(`未找到 ${kernelName} Kernel；请安装对应 CLI，或设置 ${variable}`);
+  }
+  const child = spawnSync(kernel.command, [...kernel.prefix, ...args], {
+    cwd, stdio: 'inherit', shell: false, env: process.env
+  });
+  if (child.error) throw child.error;
+  return child.status ?? 1;
+}
+
+function doctor(cwd, json) {
+  const dyyto = discoverKernel('dyyto');
+  const deploy = discoverKernel('deploy');
+  const report = {
+    schemaVersion: 1,
+    cwd,
+    project: { git: existsSync(resolve(cwd, '.git')), dyytoManifest: existsSync(resolve(cwd, '.dyyto/manifest.json')) },
+    kernels: { dyyto: Boolean(dyyto), idpDeploy: Boolean(deploy) },
+    optionalTargets: { kubectl: Boolean(commandOnPath('kubectl')) },
+    readiness: {
+      development: Boolean(dyyto),
+      deliveryPlanning: Boolean(deploy),
+      kubernetesDeployment: false
+    }
+  };
+  if (json) console.log(JSON.stringify(report));
+  else {
+    console.log('IDP 开发环境检查');
+    console.log(`工程目录：${cwd}`);
+    console.log(`工程采用 Kernel：${report.kernels.dyyto ? '已就绪' : '缺失'}`);
+    console.log(`交付部署 Kernel：${report.kernels.idpDeploy ? '已就绪' : '缺失'}`);
+    console.log(`Kubernetes 客户端：${report.optionalTargets.kubectl ? '已安装（未探测目标环境）' : '未安装（不影响本地开发）'}`);
+    console.log(`本地开发：${report.readiness.development ? '可进行' : '需先安装 Dyyto CLI'}`);
+  }
+  return report.readiness.development ? 0 : 2;
+}
+
+function help() {
+  console.log(`idp：开发者统一入口（薄门面）
+
+用法：
+  idp doctor [--cwd <目录>] [--json]
+  idp app create|inspect [--cwd <目录>] [Kernel 参数...]
+  idp capability <Dyyto 参数...> [--cwd <目录>]
+  idp delivery <idpctl 参数...> [--cwd <目录>]
+  idp environment <idpctl 参数...> [--cwd <目录>]
+
+说明：工程能力由 Dyyto Kernel 执行；交付与环境能力由 idp-deploy Kernel 执行。`);
+}
+
+try {
+  const { cwd, json, rest } = parseGlobal(process.argv.slice(2));
+  if (rest.length === 0 || rest[0] === '--help' || rest[0] === 'help') { help(); process.exit(0); }
+  const [group, action, ...args] = rest;
+  let status;
+  if (group === 'doctor') status = doctor(cwd, json);
+  else if (group === 'app' && action === 'create') status = run('dyyto', ['create', ...args], cwd);
+  else if (group === 'app' && action === 'inspect') status = run('dyyto', ['inspect', ...args], cwd);
+  else if (group === 'capability' && action) status = run('dyyto', [action, ...args], cwd);
+  else if (group === 'delivery' && action) status = run('deploy', [action, ...args], cwd);
+  else if (group === 'environment' && action) status = run('deploy', [action, ...args], cwd);
+  else throw new Error(`未知命令：${rest.join(' ')}；运行 idp --help 查看用法`);
+  process.exit(status);
+} catch (error) {
+  console.error(`错误：${error.message}`);
+  process.exit(2);
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@aipt/idp-cli",
+  "version": "0.1.0",
+  "description": "IDP 开发者统一入口，委托 Dyyto 与 idp-deploy 执行工程和交付能力。",
+  "type": "module",
+  "bin": {
+    "idp": "./bin/idp.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "check": "node --check bin/idp.mjs && npm test",
+    "example": "node scripts/run-example.mjs",
+    "example:clean": "node scripts/clean-example.mjs"
+  }
+}