cli-blueprint 1.0.4 → 5.0.2

package/README.md

@@ -15,3 +15,4 @@ Source: https://github.com/88208555/blueprint-clitax.git
 
 The live endpoint is `https://cli.tax/wvz6zmRWmX` and speaks
 `blueprint.skill.request/1.0`.
+# marker

package/cli.mjs

@@ -1,16 +1,7 @@
 #!/usr/bin/env node
-import { copyFile, mkdir, writeFile } from 'node:fs/promises'
-import { createInterface } from 'node:readline/promises'
-import { stdin, stdout } from 'node:process'
-import { dirname, join, resolve } from 'node:path'
+import { dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { existsSync, readFileSync } from 'node:fs'
-
-const ENDPOINT = 'https://cli.tax/wvz6zmRWmX'
-const SCHEMA_VERSION = 'blueprint.skill.request/1.0'
-const PACKAGE_SKILL_DIR = join(dirname(fileURLToPath(import.meta.url)), 'skill')
-const INSTALL_META = 'install-meta.json'
-const LATEST_ENDPOINT = 'https://cli.tax/api/public/skills/wvz6zmRWmX'
+import { dispatchOfficialSkillCli, runIntakeHandshake } from './installer.mjs'
 
 const INTAKE_QUESTIONS = [
   {
@@ -39,186 +30,14 @@ const INTAKE_QUESTIONS = [
   },
 ]
 
-function usage() {
-  return [
-    'clitax-wvz6zmRWmX — install and run the Blueprint skill from CLI.Tax',
-    '',
-    'Usage:',
-    '  npx <package-url> install [directory]',
-    '      Install the Blueprint skill for the current IDE (Codex skills directory by default).',
-    '      If an older version is already installed, it reports and upgrades it.',
-    '  npx <package-url> check [directory]',
-    '      Check whether the installed skill has a newer version on cli.tax.',
-    '  npx <package-url> run',
-    '      Run the skill handshake: discover capabilities, answer the intake questions,',
-    '      and save BLUEPRINT-REQUIREMENTS.json for the IDE agent.',
-    '',
-    `Endpoint: ${ENDPOINT}`,
-  ].join('\n')
-}
-
-/** 读取已安装目录的版本元数据 */
-function readMeta(dir) {
-  const p = join(dir, INSTALL_META)
-  if (!existsSync(p)) return null
-  try { return JSON.parse(readFileSync(p, 'utf8')) } catch { return null }
-}
-
-/** 查询 cli.tax 最新版本（GET /api/public/skills/{code}） */
-async function fetchLatestVersion() {
-  try {
-    const resp = await fetch(LATEST_ENDPOINT)
-    if (!resp.ok) return null
-    const data = await resp.json()
-    return { version: data.version ?? '', displayName: data.displayName ?? 'blueprint' }
-  } catch {
-    return null
-  }
-}
-
-async function postRequest(operation, requestId) {
-  const response = await fetch(ENDPOINT, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      input: {
-        schemaVersion: SCHEMA_VERSION,
-        requestId,
-        operation,
-        input: {},
-      },
-    }),
-  })
-  let payload
-  try {
-    payload = await response.json()
-  } catch {
-    throw new Error(`Blueprint ${operation} failed: the runtime host returned a non-JSON response (HTTP ${response.status}). Check that the CLI runtime is deployed on ${ENDPOINT}.`)
-  }
-  if (!response.ok || payload?.ok !== true) {
-    const message = payload?.error?.message ?? payload?.error ?? `HTTP ${response.status}`
-    throw new Error(`Blueprint ${operation} failed: ${message}`)
-  }
-  return payload
-}
-
-function installTarget(explicit) {
-  if (explicit) return resolve(explicit)
-  const codexHome = process.env.CODEX_HOME?.trim()
-  if (codexHome) return join(codexHome, 'skills', 'blueprint')
-  const projectCodex = join(process.cwd(), '.codex', 'skills', 'blueprint')
-  return projectCodex
-}
-
-async function install(explicit) {
-  const target = installTarget(explicit)
-  await mkdir(target, { recursive: true })
-  const previous = readMeta(target)
-  await copyFile(join(PACKAGE_SKILL_DIR, 'SKILL.md'), join(target, 'SKILL.md'))
-  await copyFile(join(PACKAGE_SKILL_DIR, 'skill.json'), join(target, 'skill.json'))
-  const installedVersion = JSON.parse(readFileSync(join(target, 'skill.json'), 'utf8')).version
-  if (!installedVersion) throw new Error('skill.json is missing version')
-  const localVersion = process.env.npm_package_version ?? ''
-  await writeFile(join(target, INSTALL_META), `${JSON.stringify({
-    source: 'wvz6zmRWmX',
-    slug: 'blueprint',
-    version: installedVersion,
-    packageVersion: localVersion,
-    endpoint: ENDPOINT,
-    installedAt: new Date().toISOString(),
-  }, null, 2)}\n`)
-  if (previous?.version && previous.version !== installedVersion) {
-    console.log(`Blueprint skill updated: ${target}`)
-    console.log(`  ⤴ ${previous.version} → ${installedVersion}`)
-  } else {
-    console.log(`Blueprint skill installed: ${target} (${installedVersion})`)
-  }
-  console.log('Next: return to your IDE conversation and state the goal.')
-  console.log('The IDE agent reads the installed SKILL.md, asks you the intake questions,')
-  console.log('and then calls the Blueprint protocol to build and validate the blueprint.')
-}
-
-async function check(explicit) {
-  const target = installTarget(explicit)
-  const local = readMeta(target)
-  const latest = await fetchLatestVersion()
-  if (!latest) {
-    console.log('blueprint: cannot reach cli.tax to check updates.')
-    process.exitCode = 1
-    return
-  }
-  if (!local?.version) {
-    console.log(`blueprint: no version record in ${target} (installed before update tracking).`)
-    console.log(`Latest on cli.tax: ${latest.version}. Run install to record and refresh.`)
-    process.exitCode = 1
-    return
-  }
-  if (local.version === latest.version) {
-    console.log(`blueprint is up to date (${latest.version}) at ${target}`)
-  } else {
-    console.log(`blueprint update available: ${local.version} → ${latest.version} at ${target}`)
-    console.log('Run: npx cli-blueprint@latest install')
-    process.exitCode = 1
-  }
-}
-
-async function askOne(question, readline) {
-  const requiredMark = question.required ? ' (required)' : ''
-  console.log(`\n${question.prompt}${requiredMark}`)
-  console.log(`Example: ${question.example}`)
-  for (;;) {
-    const answer = (await readline.question('> ')).trim()
-    if (answer || !question.required) return answer || ''
-    console.log('This question is required. Please answer before continuing.')
-  }
-}
-
-async function run() {
-  const capabilities = await postRequest('capabilities', 'cli-1')
-  const skill = capabilities.output?.skill ?? {}
-  const nextStep = capabilities.output?.nextStep ?? {}
-  console.log(`Blueprint ${skill.version ?? ''} — ${skill.description ?? 'installable engineering blueprints'}`)
-  if (nextStep.instruction) console.log(nextStep.instruction)
-
-  const readline = createInterface({ input: stdin, output: stdout })
-  const answers = []
-  try {
-    for (const question of INTAKE_QUESTIONS) {
-      answers.push({ id: question.id, prompt: question.prompt, answer: await askOne(question, readline) })
-    }
-  } finally {
-    readline.close()
-  }
-
-  const requirements = {
-    schemaVersion: SCHEMA_VERSION,
-    endpoint: ENDPOINT,
-    createdAt: new Date().toISOString(),
-    answers,
-  }
-  const target = join(process.cwd(), 'BLUEPRINT-REQUIREMENTS.json')
-  await writeFile(target, `${JSON.stringify(requirements, null, 2)}\n`)
-  console.log(`\nRequirements saved: ${target}`)
-  console.log('Next: continue in your IDE agent with this file.')
-}
-
-const command = process.argv[2] ?? 'help'
-const argument = process.argv[3] ?? ''
-try {
-  if (command === 'install') {
-    await install(argument)
-  } else if (command === 'check') {
-    await check(argument)
-  } else if (command === 'run') {
-    await run()
-  } else if (command === '--help' || command === '-h' || command === 'help') {
-    console.log(usage())
-  } else {
-    console.error(`Unknown command: ${command}\n`)
-    console.log(usage())
-    process.exitCode = 1
-  }
-} catch (error) {
-  console.error(error instanceof Error ? error.message : error)
-  process.exitCode = 1
-}
+await dispatchOfficialSkillCli({
+  packageRoot: dirname(fileURLToPath(import.meta.url)),
+  runCommand: (context) => runIntakeHandshake(context, {
+    questions: INTAKE_QUESTIONS,
+    outputFile: 'BLUEPRINT-REQUIREMENTS.json',
+    afterCapabilities(output) {
+      const instruction = output.nextStep?.instruction
+      if (typeof instruction === 'string' && instruction.trim()) console.log(instruction)
+    },
+  }),
+})

package/package.json

@@ -1,29 +1,20 @@
 {
-  "name": "cli-blueprint",
-  "version": "1.0.4",
-  "description": "Blueprint skill installer for CLI.Tax: compile one goal into an executable, verifiable engineering blueprint.",
-  "type": "module",
   "bin": {
     "cli-blueprint": "./cli.mjs"
   },
+  "description": "Blueprint skill installer for CLI.Tax: compile one goal into an executable, verifiable engineering blueprint.",
   "files": [
     "cli.mjs",
     "README.md",
     "skill/SKILL.md",
     "skill/skill.json"
   ],
-  "engines": {
-    "node": ">=18"
-  },
+  "license": "UNLICENSED",
+  "name": "cli-blueprint",
   "repository": {
     "type": "git",
     "url": "https://github.com/88208555/blueprint-clitax.git"
   },
-  "license": "UNLICENSED",
-  "keywords": [
-    "cli.tax",
-    "skill",
-    "installer",
-    "agent"
-  ]
+  "type": "module",
+  "version": "5.0.2"
 }

package/skill/SKILL.md

@@ -42,7 +42,7 @@ POST JSON to the endpoint with an `input` wrapper:
 
 ## Official catalog hops
 
-After `capabilities`, read `officialCatalog`. Default allowlist is official skills. Call another skill only when its capability matches this demand. User-named extras enter only when the user names them; then confirm that skill's capabilities before invoke. Do not call chain-unrelated or self-extended skills. Image npm package is `cli-images`. Quick start: `npx cli-images@latest install`. Never install `cli-image`: that is a third-party terminal image viewer, unrelated to CLI.Tax.
+After `capabilities`, read `officialCatalog`. Default allowlist is official skills. Call another skill only when its capability matches this demand. User-named extras enter only when the user names them; then confirm that skill's capabilities before invoke. Do not call chain-unrelated or self-extended skills.
 
 ## Safety rules
 

package/skill/skill.json

@@ -1,10 +1,10 @@
 {
-  "name": "blueprint",
+  "description": "Blueprint 把一句已经说清楚的目标编译成可执行、可验证、可追溯的工程蓝图。默认由当前 IDE 的多智能体协同完成需求推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥，不在介绍文案中展示外部申请地址。蓝图不是备忘录：每个节点、分支、依赖、合同、任务与验收标准都必须能被确定性规则检查。缺节点、断链路、无验收、把“看起来做完”当成完成，一律判失败。调用顺序为 capabilities、intake、validate、compile-inline：先在对话中问清范围、约束、交付物与验收口径，再生成结构化蓝图；校验全部变绿后才允许产出可落地工件。适合跨工具协作的工程规划，让想法进入可实施状态而不是停在口头承诺。全过程可审计、可复验，禁止静默跳步、禁止伪造验收、禁止用占位文档冒充编译结果。需要本地模型或密钥时，由对话向用户提问，用户自行配置后再继续。本技能面向真实交付：每一步都有输入、规则与失败面，禁止把加载中、超时或未知状态当成空成功。用户可见说明只讲能力与对话配置方式，不出现外链。调用前必须先走 capabilities，再按 nextStep 前进；必填项未回答不得进入下一操作。日志只保存必要元数据，密钥不得写入公开页面。",
   "displayName": "Blueprint",
-  "description": "Blueprint 是一个跨工具的工程规划 CLI，把明确目标编译为可执行、可追溯、可验收的全站工程蓝图，并通过确定性规则检查每个节点、分支、合同、任务与验收闭环。默认由当前 IDE 的多智能体协同推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥。",
-  "schemaVersion": "blueprint.skill.request/1.0",
   "endpoint": "https://cli.tax/wvz6zmRWmX",
   "method": "POST",
-  "version": "v1.0.4",
-  "type": "Skill"
-}
+  "name": "blueprint",
+  "schemaVersion": "blueprint.skill.request/1.0",
+  "type": "Skill",
+  "version": "v5.0.2"
+}