@projitive/mcp 1.0.1 → 1.0.3

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectContext.md

@@ -0,0 +1,48 @@
+# projectContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive"}
+
+## Output
+
+# projectContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- tasksFile: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+- roadmapIds: 1
+
+## Evidence
+### Task Summary
+- total: 1
+- TODO: 1
+- IN_PROGRESS: 0
+- BLOCKED: 0
+- DONE: 0
+
+### Artifacts
+- ✅ README.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/README.md  
+  lineCount: 8
+- ✅ roadmap.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md  
+  lineCount: 4
+- ✅ tasks.md  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md  
+  lineCount: 11
+- ✅ designs/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+- ✅ reports/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/reports
+- ✅ hooks/  
+  path: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks
+
+## Agent Guidance
+- Start from `taskList` to choose a target task.
+- Then call `taskContext` with a task ID to retrieve evidence locations and reading order.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- taskList(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectInit.md

@@ -0,0 +1,40 @@
+# projectInit
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke","governanceDir":".projitive","force":true}
+
+## Output
+
+# projectInit
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- markerPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+- force: true
+
+## Evidence
+- createdFiles: 4
+- updatedFiles: 0
+- skippedFiles: 0
+- directories:
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/reports
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks
+- files:
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/README.md
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md
+  - created: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- If files were skipped and you want to overwrite templates, rerun with force=true.
+- Continue with projectContext and taskList for execution.
+
+## Lint Suggestions
+- After init, fill owner/roadmapRefs/links in tasks.md before marking DONE.
+- Keep task source-of-truth inside marker block only.
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectLocate.md

@@ -0,0 +1,22 @@
+# projectLocate
+
+- passed: true
+- args: {"inputPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs"}
+
+## Output
+
+# projectLocate
+
+## Summary
+- resolvedFrom: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- markerPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/.projitive
+
+## Agent Guidance
+- Call `projectContext` with this governanceDir to get task and roadmap summaries.
+
+## Lint Suggestions
+- Run `projectContext` to get governance/module lint suggestions for this project.
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectNext.md

@@ -0,0 +1,31 @@
+# projectNext
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github","maxDepth":2,"limit":5}
+
+## Output
+
+# projectNext
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github
+- maxDepth: 2
+- matchedProjects: 2
+- actionableProjects: 2
+- limit: 5
+
+## Evidence
+- rankedProjects:
+1. /Users/yinxulai/Documents/Github/projitive/.projitive | actionable=3 | in_progress=1 | todo=2 | blocked=0 | done=0 | latest=2026-02-17T23:50:00.000Z | tasksPath=/Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md
+2. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive | actionable=1 | in_progress=0 | todo=1 | blocked=0 | done=0 | latest=2026-02-18T13:18:19.890Z | tasksPath=/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- Pick top 1 project and call `projectContext` with its governanceDir.
+- Then call `taskList` and `taskContext` to continue execution.
+- If `tasksPath` is missing, create tasks.md using project convention before task-level operations.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- projectContext(projectPath="/Users/yinxulai/Documents/Github/projitive/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/projectScan.md

@@ -0,0 +1,28 @@
+# projectScan
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github","maxDepth":2}
+
+## Output
+
+# projectScan
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github
+- maxDepth: 2
+- discoveredCount: 2
+
+## Evidence
+- projects:
+1. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+2. /Users/yinxulai/Documents/Github/projitive/.projitive
+
+## Agent Guidance
+- Use one discovered project path and call `projectLocate` to lock governance root.
+- Then call `projectContext` to inspect current governance state.
+
+## Lint Suggestions
+- Run `projectContext` on a discovered project to receive module-level lint suggestions.
+
+## Next Call
+- projectLocate(inputPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/roadmapContext.md

@@ -0,0 +1,33 @@
+# roadmapContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","roadmapId":"ROADMAP-0001"}
+
+## Output
+
+# roadmapContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- roadmapId: ROADMAP-0001
+- relatedTasks: 1
+- references: 2
+
+## Evidence
+### Related Tasks
+- TASK-0001 | TODO | Bootstrap governance workspace
+
+### Reference Locations
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/roadmap.md#L4: - [ ] ROADMAP-0001: Bootstrap governance baseline (time: 2026-Q1)
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L9: - roadmapRefs: ROADMAP-0001
+
+## Agent Guidance
+- Read roadmap references first, then related tasks.
+- Keep ROADMAP/TASK IDs unchanged while updating markdown files.
+- Re-run `roadmapContext` after edits to confirm references remain consistent.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- roadmapContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", roadmapId="ROADMAP-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/roadmapList.md

@@ -0,0 +1,25 @@
+# roadmapList
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","limit":5}
+
+## Output
+
+# roadmapList
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- roadmapCount: 1
+
+## Evidence
+- roadmaps:
+- ROADMAP-0001 | linkedTasks=1
+
+## Agent Guidance
+- Pick one roadmap ID and call `roadmapContext`.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- roadmapContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", roadmapId="ROADMAP-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/summary.json

@@ -0,0 +1,90 @@
+{
+  "root": "/Users/yinxulai/Documents/Github",
+  "workspace": "/Users/yinxulai/Documents/Github/projitive",
+  "sandbox": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke",
+  "reportDir": "/Users/yinxulai/Documents/Github/projitive/packages/mcp/output/smoke-reports/2026-02-18T13-18-19-740Z",
+  "generatedAt": "2026-02-18T13:18:20.412Z",
+  "results": [
+    {
+      "methodName": "projectInit",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke",
+        "governanceDir": ".projitive",
+        "force": true
+      }
+    },
+    {
+      "methodName": "projectScan",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2
+      }
+    },
+    {
+      "methodName": "projectNext",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2,
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "projectLocate",
+      "passed": true,
+      "args": {
+        "inputPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/designs"
+      }
+    },
+    {
+      "methodName": "projectContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive"
+      }
+    },
+    {
+      "methodName": "taskList",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "taskNext",
+      "passed": true,
+      "args": {
+        "rootPath": "/Users/yinxulai/Documents/Github",
+        "maxDepth": 2,
+        "topCandidates": 5
+      }
+    },
+    {
+      "methodName": "taskContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "taskId": "TASK-0001"
+      }
+    },
+    {
+      "methodName": "roadmapList",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "limit": 5
+      }
+    },
+    {
+      "methodName": "roadmapContext",
+      "passed": true,
+      "args": {
+        "projectPath": "/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive",
+        "roadmapId": "ROADMAP-0001"
+      }
+    }
+  ]
+}

package/output/smoke-reports/2026-02-18T13-18-19-740Z/summary.md

@@ -0,0 +1,17 @@
+# MCP Smoke Summary
+
+- root: /Users/yinxulai/Documents/Github
+- workspace: /Users/yinxulai/Documents/Github/projitive
+- sandbox: /Users/yinxulai/Documents/Github/projitive-mcp-smoke
+
+## Results
+- PASS | projectInit
+- PASS | projectScan
+- PASS | projectNext
+- PASS | projectLocate
+- PASS | projectContext
+- PASS | taskList
+- PASS | taskNext
+- PASS | taskContext
+- PASS | roadmapList
+- PASS | roadmapContext

package/output/smoke-reports/2026-02-18T13-18-19-740Z/taskContext.md

@@ -0,0 +1,47 @@
+# taskContext
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","taskId":"TASK-0001"}
+
+## Output
+
+# taskContext
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- taskId: TASK-0001
+- title: Bootstrap governance workspace
+- status: TODO
+- owner: unassigned
+- updatedAt: 2026-02-18T13:18:19.890Z
+- roadmapRefs: ROADMAP-0001
+- taskLocation: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L4
+- hookStatus: head=missing, footer=missing
+
+## Evidence
+### Related Artifacts
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+### Reference Locations
+- /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md#L4: ## TASK-0001 | TODO | Bootstrap governance workspace
+
+### Hook Paths
+- (none)
+
+### Suggested Read Order
+1. /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+
+## Agent Guidance
+- Read the files in Suggested Read Order.
+- Verify whether current status and evidence are consistent.
+- This task is TODO: confirm scope and set execution plan before edits.
+- Move to IN_PROGRESS only after owner and initial evidence are ready.
+- If updates are needed, edit tasks/designs/reports markdown directly and keep TASK IDs unchanged.
+- After editing, re-run `taskContext` to verify references and context consistency.
+
+## Lint Suggestions
+- [TASK_CONTEXT_HOOK_HEAD_MISSING] Missing /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks/task_get_head.md. Add a task context head hook template if you need standardized preface.
+- [TASK_CONTEXT_HOOK_FOOTER_MISSING] Missing /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/hooks/task_get_footer.md. Add a task context footer hook template for standardized close-out checks.
+
+## Next Call
+- taskContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", taskId="TASK-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/taskList.md

@@ -0,0 +1,27 @@
+# taskList
+
+- passed: true
+- args: {"projectPath":"/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive","limit":5}
+
+## Output
+
+# taskList
+
+## Summary
+- governanceDir: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive
+- tasksPath: /Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive/tasks.md
+- filter.status: (none)
+- returned: 1
+
+## Evidence
+- tasks:
+- TASK-0001 | TODO | Bootstrap governance workspace | owner=unassigned | updatedAt=2026-02-18T13:18:19.890Z
+
+## Agent Guidance
+- Pick one task ID and call `taskContext`.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- taskContext(projectPath="/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive", taskId="TASK-0001")

package/output/smoke-reports/2026-02-18T13-18-19-740Z/taskNext.md

@@ -0,0 +1,64 @@
+# taskNext
+
+- passed: true
+- args: {"rootPath":"/Users/yinxulai/Documents/Github","maxDepth":2,"topCandidates":5}
+
+## Output
+
+# taskNext
+
+## Summary
+- rootPath: /Users/yinxulai/Documents/Github
+- maxDepth: 2
+- matchedProjects: 2
+- actionableTasks: 4
+- selectedProject: /Users/yinxulai/Documents/Github/projitive/.projitive
+- selectedTaskId: TASK-0001
+- selectedTaskStatus: IN_PROGRESS
+
+## Evidence
+### Selected Task
+- id: TASK-0001
+- title: Bootstrap repository self-management governance
+- owner: ai-copilot
+- updatedAt: 2026-02-17T23:50:00.000Z
+- roadmapRefs: ROADMAP-0001
+- taskLocation: /Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md#L6
+
+### Top Candidates
+1. TASK-0001 | IN_PROGRESS | Bootstrap repository self-management governance | project=/Users/yinxulai/Documents/Github/projitive/.projitive | projectScore=4 | latest=2026-02-17T23:50:00.000Z
+2. TASK-0002 | TODO | Stabilize default task.next workflow | project=/Users/yinxulai/Documents/Github/projitive/.projitive | projectScore=4 | latest=2026-02-17T23:50:00.000Z
+3. TASK-0003 | TODO | Prepare spec v1.1 governance change proposal | project=/Users/yinxulai/Documents/Github/projitive/.projitive | projectScore=4 | latest=2026-02-17T23:50:00.000Z
+4. TASK-0001 | TODO | Bootstrap governance workspace | project=/Users/yinxulai/Documents/Github/projitive-mcp-smoke/.projitive | projectScore=1 | latest=2026-02-18T13:18:19.890Z
+
+### Selection Reason
+- Rank rule: projectScore DESC -> taskPriority DESC -> taskUpdatedAt DESC.
+- Selected candidate scores: projectScore=4, taskPriority=2, taskUpdatedAtMs=1771372200000.
+
+### Related Artifacts
+- /Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md
+- /Users/yinxulai/Documents/Github/projitive/.projitive/designs/self-management-bootstrap.md
+- /Users/yinxulai/Documents/Github/projitive/.projitive/reports/bootstrap-2026-02-17.md
+
+### Reference Locations
+- /Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md#L6: ## TASK-0001 | IN_PROGRESS | Bootstrap repository self-management governance
+- /Users/yinxulai/Documents/Github/projitive/.projitive/designs/self-management-bootstrap.md#L1: Task: TASK-0001
+- /Users/yinxulai/Documents/Github/projitive/.projitive/designs/self-management-bootstrap.md#L23: - Verify `task.next` can identify `TASK-0001` as actionable.
+- /Users/yinxulai/Documents/Github/projitive/.projitive/reports/bootstrap-2026-02-17.md#L1: Task: TASK-0001
+- /Users/yinxulai/Documents/Github/projitive/.projitive/reports/bootstrap-2026-02-17.md#L17: - Continue TASK-0001 until first full `task.next` execution cycle is recorded.
+
+### Suggested Read Order
+1. /Users/yinxulai/Documents/Github/projitive/.projitive/tasks.md
+2. /Users/yinxulai/Documents/Github/projitive/.projitive/designs/self-management-bootstrap.md
+3. /Users/yinxulai/Documents/Github/projitive/.projitive/reports/bootstrap-2026-02-17.md
+
+## Agent Guidance
+- Start immediately with Suggested Read Order and execute the selected task.
+- Update markdown artifacts directly while keeping TASK/ROADMAP IDs unchanged.
+- Re-run `taskContext` for the selectedTaskId after edits to verify evidence consistency.
+
+## Lint Suggestions
+- (none)
+
+## Next Call
+- taskContext(projectPath="/Users/yinxulai/Documents/Github/projitive/.projitive", taskId="TASK-0001")

package/output/source/designs.js

@@ -0,0 +1,38 @@
+import { isValidRoadmapId } from "./roadmap.js";
+import { isValidTaskId } from "./tasks.js";
+export function parseDesignMetadata(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const metadata = {};
+    for (const line of lines) {
+        const [rawKey, ...rawValue] = line.split(":");
+        if (!rawKey || rawValue.length === 0) {
+            continue;
+        }
+        const key = rawKey.trim().toLowerCase();
+        const value = rawValue.join(":").trim();
+        if (key === "task")
+            metadata.task = value;
+        if (key === "roadmap")
+            metadata.roadmap = value;
+        if (key === "owner")
+            metadata.owner = value;
+        if (key === "status")
+            metadata.status = value;
+        if (key === "last updated")
+            metadata.lastUpdated = value;
+    }
+    return metadata;
+}
+export function validateDesignMetadata(metadata) {
+    const errors = [];
+    if (!metadata.task) {
+        errors.push("Missing Task metadata");
+    }
+    else if (!isValidTaskId(metadata.task)) {
+        errors.push(`Invalid Task metadata format: ${metadata.task}`);
+    }
+    if (metadata.roadmap && !isValidRoadmapId(metadata.roadmap)) {
+        errors.push(`Invalid Roadmap metadata format: ${metadata.roadmap}`);
+    }
+    return { ok: errors.length === 0, errors };
+}

package/output/source/helpers/artifacts/artifacts.js

@@ -0,0 +1,10 @@
+export function candidateFilesFromArtifacts(artifacts) {
+    return artifacts
+        .filter((item) => item.exists)
+        .flatMap((item) => {
+        if (item.kind === "file") {
+            return [item.path];
+        }
+        return (item.markdownFiles ?? []).map((entry) => entry.path);
+    });
+}

package/output/source/helpers/artifacts/artifacts.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { candidateFilesFromArtifacts } from "./artifacts.js";
+describe("candidateFilesFromArtifacts", () => {
+    it("collects existing file artifacts and markdown files from existing directories", () => {
+        const candidates = candidateFilesFromArtifacts([
+            { name: "README.md", kind: "file", path: "/a/README.md", exists: true, lineCount: 3 },
+            { name: "tasks.md", kind: "file", path: "/a/tasks.md", exists: false },
+            {
+                name: "designs",
+                kind: "directory",
+                path: "/a/designs",
+                exists: true,
+                markdownFiles: [{ path: "/a/designs/d1.md", lineCount: 10 }],
+            },
+        ]);
+        expect(candidates).toEqual(["/a/README.md", "/a/designs/d1.md"]);
+    });
+});

package/output/source/helpers/artifacts/index.js

@@ -0,0 +1 @@
+export * from "./artifacts.js";

package/output/source/helpers/catch/catch.js

@@ -0,0 +1,48 @@
+// 辅助函数：检查是否为 PromiseLike
+function isPromiseLike(value) {
+    return value != null && typeof value === 'object' && 'then' in value && typeof value.then === 'function';
+}
+/**
+ * 构造成功结果对象
+ * isError 始终返回 false
+ */
+function createSuccess(value) {
+    return {
+        value,
+        error: undefined,
+        isError() { return false; }
+    };
+}
+/**
+ * 构造失败结果对象
+ * isError 始终返回 true
+ */
+function createFailure(error) {
+    return {
+        error,
+        value: undefined,
+        isError() { return true; }
+    };
+}
+export async function catchIt(input) {
+    try {
+        if (isPromiseLike(input)) {
+            const result = await Promise.resolve(input);
+            return createSuccess(result);
+        }
+        else if (typeof input === 'function') {
+            const result = input();
+            if (isPromiseLike(result)) {
+                return catchIt(result);
+            }
+            else {
+                return createSuccess(result);
+            }
+        }
+    }
+    catch (error) {
+        return createFailure(error);
+    }
+    // 理论上不会到达这里，兜底类型安全
+    return createFailure(new Error('Unexpected input type'));
+}

package/output/source/helpers/catch/catch.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { catchIt } from './catch.js';
+describe('catchIt', () => {
+    it('同步函数返回值应为 value，error 为 undefined，isError 为 false', async () => {
+        const result = await catchIt(() => 123);
+        expect(result.value).toBe(123);
+        expect(result.error).toBeUndefined();
+        expect(result.isError()).toBe(false);
+    });
+    it('异步函数返回值应为 value，error 为 undefined，isError 为 false', async () => {
+        const result = await catchIt(async () => 456);
+        expect(result.value).toBe(456);
+        expect(result.error).toBeUndefined();
+        expect(result.isError()).toBe(false);
+    });
+    it('同步抛出异常时应返回 error，value 为 undefined，isError 为 true', async () => {
+        const error = new Error('fail');
+        const result = await catchIt(() => { throw error; });
+        expect(result.value).toBeUndefined();
+        expect(result.error).toBe(error);
+        expect(result.isError()).toBe(true);
+    });
+    it('异步抛出异常时应返回 error，value 为 undefined，isError 为 true', async () => {
+        const error = new Error('fail-async');
+        const result = await catchIt(() => Promise.reject(error));
+        expect(result.value).toBeUndefined();
+        expect(result.error).toBe(error);
+        expect(result.isError()).toBe(true);
+    });
+    it('PromiseLike resolve 时应返回 value，error 为 undefined，isError 为 false', async () => {
+        const result = await catchIt(Promise.resolve('ok'));
+        expect(result.value).toBe('ok');
+        expect(result.error).toBeUndefined();
+        expect(result.isError()).toBe(false);
+    });
+    it('PromiseLike reject 时应返回 error，value 为 undefined，isError 为 true', async () => {
+        const error = new Error('promise-fail');
+        const result = await catchIt(Promise.reject(error));
+        expect(result.value).toBeUndefined();
+        expect(result.error).toBe(error);
+        expect(result.isError()).toBe(true);
+    });
+});

package/output/source/helpers/catch/index.js

@@ -0,0 +1 @@
+export * from './catch.js';