@wandoupeas/coding-forge 0.1.0 → 0.1.2

package/README.md

@@ -43,26 +43,29 @@ WebForge 是一个面向 Coding Agent 的 `agent-first harness` 参考实现。
 
 ## 快速开始
 
-先构建 CLI：
+### 安装方式
+
+**方式一：本地源码部署（开发/调试）**
 
 ```bash
 npm install
 npm run build
+# 使用方式: node dist/cli/index.js <command>
 ```
 
-如果你是 npm 使用者，安装方式会是：
+**方式二：npm 全局安装（推荐）**
 
 ```bash
 npm install -g @wandoupeas/coding-forge
-```
+# 使用方式: webforge <command>
 
-或者直接临时运行：
-
-```bash
+# 或临时运行
 npx @wandoupeas/coding-forge --help
 ```
 
-然后初始化一个新仓库：
+### 初始化仓库
+
+以下命令以**本地源码**方式演示，如果你使用 npm 安装，请将 `node dist/cli/index.js` 替换为 `webforge`：
 
 ```bash
 node dist/cli/index.js init demo-app
@@ -78,14 +81,23 @@ node dist/cli/index.js init demo-app
 初始化完成后，进入新仓库先运行：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js doctor
+
+# 或 npm 安装方式
+webforge doctor
 ```
 
 如果你希望让正在仓库里工作的 agent 直接消费结构化状态，可以使用：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js doctor --json
 node dist/cli/index.js resume --json
+
+# 或 npm 安装方式
+webforge doctor --json
+webforge resume --json
 ```
 
 这两个命令分别回答：
@@ -96,21 +108,19 @@ node dist/cli/index.js resume --json
 如果你想用本地 Web UI 统一查看多个 WebForge 项目，可以直接启动：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js ui --root ~/projects
-```
-
-如果你已经通过 npm 安装，则等价命令是：
 
-```bash
+# 或 npm 安装方式
 webforge ui --root ~/projects
 ```
 
-这个 UI 当前是只读监控台，会自动扫描根目录下带 `.webforge/` 的项目，并提供：
+这个 UI 当前是只读监控台，会自动扫描根目录下带 `.webforge/` 的项目，并提供一套更接近“研究终端”的观察面：
 
-- 多项目总览
-- 单项目 dashboard
-- 文档 / 交付物 / session 浏览
-- runtime / drift / checkpoint / mailbox / superpowers 观察
+- 首页 `Project Index + Workspace Ledger + Signal Rail`
+- 单项目统一 `Summary / Evidence / Runtime` 骨架
+- knowledge / deliverables / sessions 的资源浏览器
+- runtime 事件流、双快照对照、checkpoint / drift / mailbox / superpowers 观察
 
 ## 怎么使用
 
@@ -128,14 +138,12 @@ webforge ui --root ~/projects
 推荐最短使用路径：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js init demo-app
 cd demo-app
 node /path/to/work-forge/dist/cli/index.js onboard --json
-```
-
-如果你已经通过 npm 安装，则等价命令是：
 
-```bash
+# 或 npm 安装方式
 webforge init demo-app
 cd demo-app
 webforge onboard --json
@@ -172,10 +180,10 @@ webforge ui --root ~/projects
 
 推荐用法：
 
-1. 在首页看项目健康、blocked、pending review、drift
-2. 进入单项目页看 recovery、tasks、deliverables 和 runtime pulse
-3. 切到 `Artifacts` 页直接看 knowledge / deliverable / session 文本预览
-4. 切到 `Runtime` 页看日志快照 vs 当前工作区快照，以及 checkpoint 列表
+1. 在首页用 `Project Index` 快速切项目，用 `Workspace Ledger` 看当前快照，用 `Signal Rail` 盯住 blocked / pending review / drift
+2. 进入单项目后，始终先看右侧 recovery rail，再决定沿 `Summary / Evidence / Runtime` 哪条视角继续
+3. 在 `Evidence` 里把 knowledge / deliverable / session 当资源浏览器来读，而不是翻三列卡片
+4. 在 `Runtime` 里优先看 `Recent events` 和 `Snapshots comparison`，再看 drift reasons 和 checkpoint
 
 ## 仓库结构
 
@@ -251,22 +259,37 @@ WebForge 和 `superpowers` 不是互相替代的关系：
 如果你是人类开发者在仓库里工作，推荐顺序是：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js doctor
 node dist/cli/index.js resume
 node dist/cli/index.js dashboard
+
+# 或 npm 安装方式
+webforge doctor
+webforge resume
+webforge dashboard
 ```
 
 如果你是希望让 agent 直接消费仓库状态，推荐顺序是：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js onboard --json
+
+# 或 npm 安装方式
+webforge onboard --json
 ```
 
 或者显式拆开：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js doctor --json
 node dist/cli/index.js resume --json
+
+# 或 npm 安装方式
+webforge doctor --json
+webforge resume --json
 ```
 
 标准含义：
@@ -316,26 +339,46 @@ node dist/cli/index.js resume --json
 npm run test:unit
 npm run build
 npm run smoke:onboarding
+
+# 本地源码方式
 node dist/cli/index.js --help
 node dist/cli/index.js doctor
+
+# 或 npm 安装方式
+webforge --help
+webforge doctor
 ```
 
 常用结构化观察命令：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js onboard --json
 node dist/cli/index.js doctor --json
 node dist/cli/index.js resume --json
 node dist/cli/index.js logs runtime --json
+
+# 或 npm 安装方式
+webforge onboard --json
+webforge doctor --json
+webforge resume --json
+webforge logs runtime --json
 ```
 
 常用 workflow 回写命令：
 
 ```bash
+# 本地源码方式
 node dist/cli/index.js superpowers record writing-plans \
   --summary "approved spec converted into execution plan" \
   --artifact plan:docs/superpowers/plans/demo-plan.md \
   --task T001
+
+# 或 npm 安装方式
+webforge superpowers record writing-plans \
+  --summary "approved spec converted into execution plan" \
+  --artifact plan:docs/superpowers/plans/demo-plan.md \
+  --task T001
 ```
 
 ## 项目状态

package/dist/cli/commands/init.d.ts

@@ -14,6 +14,7 @@ export interface InitVerificationSummary {
 export declare function createInitCommand(): Command;
 export declare function initProject(projectName: string, options: {
     template?: string;
+    inPlace?: boolean;
 }, basePath?: string): Promise<void>;
 export declare function buildInitVerificationSummary(projectRoot: string): Promise<InitVerificationSummary>;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAe3C;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmCf;AAuBD,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAwBlC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAgB3C;AAED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EACjD,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAuBD,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAwBlC"}

package/dist/cli/commands/init.js

@@ -14,6 +14,7 @@ export function createInitCommand() {
         .description('初始化 WebForge 项目')
         .argument('<project-name>', '项目名称')
         .option('-t, --template <template>', '项目模板', 'default')
+        .option('--in-place', '在当前目录就地初始化（不创建子目录）')
         .action(async (projectName, options) => {
         try {
             await initProject(projectName, options);
@@ -27,7 +28,7 @@ export function createInitCommand() {
 }
 export async function initProject(projectName, options, basePath = process.cwd()) {
     logger.info(`初始化项目: ${projectName}\n`);
-    const projectRoot = join(basePath, projectName);
+    const projectRoot = options.inPlace ? basePath : join(basePath, projectName);
     const state = await createWorkspace(projectRoot, {
         projectName,
         template: options.template
@@ -45,15 +46,25 @@ export async function initProject(projectName, options, basePath = process.cwd()
     logger.info('验证入口: webforge verify init');
     console.log();
     logger.info('下一步:');
-    logger.list([
-        `cd ${projectName}`,
-        `workspace: ${state.paths.workspace}`,
-        `runtime: ${state.paths.runtime}`,
-        'webforge onboard --json',
-        '如需重跑初始化后自检，执行 webforge verify init',
-        '必要时再拆开执行 webforge doctor / webforge resume / webforge logs runtime',
-        '把需求文档放进 .webforge/knowledge/requirements/'
-    ]);
+    const nextSteps = options.inPlace
+        ? [
+            `workspace: ${state.paths.workspace}`,
+            `runtime: ${state.paths.runtime}`,
+            'webforge onboard --json',
+            '如需重跑初始化后自检，执行 webforge verify init',
+            '必要时再拆开执行 webforge doctor / webforge resume / webforge logs runtime',
+            '把需求文档放进 .webforge/knowledge/requirements/'
+        ]
+        : [
+            `cd ${projectName}`,
+            `workspace: ${state.paths.workspace}`,
+            `runtime: ${state.paths.runtime}`,
+            'webforge onboard --json',
+            '如需重跑初始化后自检，执行 webforge verify init',
+            '必要时再拆开执行 webforge doctor / webforge resume / webforge logs runtime',
+            '把需求文档放进 .webforge/knowledge/requirements/'
+        ];
+    logger.list(nextSteps);
     console.log();
 }
 async function scaffoldRepoContract(projectRoot, projectName) {

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/record.d.ts

@@ -0,0 +1,11 @@
+/**
+ * record 命令 - 旁路回写
+ *
+ * 当 agent 直接在仓库里工作（不走 webforge run 主循环）时，
+ * 用这个命令把已完成的工作回写到 .webforge/。
+ *
+ * 这解决了 harness 的核心缺陷：只有 runtime 主循环内部才会自动回写状态。
+ */
+import { Command } from 'commander';
+export declare function createRecordCommand(): Command;
+//# sourceMappingURL=record.d.ts.map

package/dist/cli/commands/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/record.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,wBAAgB,mBAAmB,IAAI,OAAO,CAkF7C"}