autocrew 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autocrew",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "One-person content studio powered by AI — from trending topics to published posts",
   "type": "module",
   "license": "MIT",

package/src/adapters/research/tikhub.ts

@@ -7,13 +7,12 @@ export interface TikHubResearchQuery {
 }
 
 export async function researchWithTikHub(
-  query: TikHubResearchQuery,
+  _query: TikHubResearchQuery,
 ): Promise<ResearchItem[]> {
-  const limit = query.limit || 5;
-  return Array.from({ length: limit }).map((_, index) => ({
-    title: `${query.keyword} API 候选 ${index + 1}`,
-    summary: "TikHub fallback placeholder. Replace with a real provider call only when browser-first mode is unavailable.",
-    platform: query.platform,
-    source: "api_provider",
-  }));
+  // TikHub adapter is not implemented — return empty to trigger proper fallback.
+  // Previously returned fake placeholder items ("API 候选 1/2/3") which polluted
+  // the topic pool with useless entries. Empty array forces research.ts to fall
+  // through to free engine or return an actionable error with suggestion to use
+  // autocrew_intel pull instead.
+  return [];
 }

package/src/cli/commands/contents.ts

@@ -2,17 +2,34 @@ import type { CommandDef } from "./index.js";
 
 export const cmd: CommandDef = {
   name: "contents",
-  description: "List content items",
+  description: "List content items (legacy + pipeline projects)",
   usage: "autocrew contents",
   action: async (_args, runner) => {
     const result = await runner.execute("autocrew_content", { action: "list" });
-    const items = (result.items || []) as any[];
-    if (items.length === 0) {
-      console.log("No content yet. Use 'autocrew_content' tool to save drafts.");
+
+    // Legacy contents (local-store)
+    const contents = (result.contents || result.items || []) as any[];
+    // Pipeline projects (drafting/production/published)
+    const pipelineProjects = (result.pipelineProjects || []) as any[];
+
+    if (contents.length === 0 && pipelineProjects.length === 0) {
+      console.log("No content yet. Use autocrew_content action='save' to create drafts.");
       return;
     }
-    for (const c of items) {
-      console.log(`[${c.id}] ${c.title} — ${c.status} (${c.platform || "general"})`);
+
+    if (contents.length > 0) {
+      console.log("Legacy contents:");
+      for (const c of contents) {
+        console.log(`  [${c.id}] ${c.title} — ${c.status} (${c.platform || "general"})`);
+      }
+    }
+
+    if (pipelineProjects.length > 0) {
+      if (contents.length > 0) console.log("");
+      console.log("Pipeline projects:");
+      for (const p of pipelineProjects) {
+        console.log(`  [${p.slug}] ${p.title} — ${p.stage} (${p.current})`);
+      }
     }
   },
 };

package/src/cli/commands/versions.ts

@@ -2,21 +2,49 @@ import type { CommandDef } from "./index.js";
 
 export const cmd: CommandDef = {
   name: "versions",
-  description: "List version history for a content project",
-  usage: "autocrew versions <content-id>",
+  description: "List version history for a content project (draft versions + asset versions)",
+  usage: "autocrew versions <project-slug-or-content-id>",
   action: async (args, runner) => {
-    const contentId = args[0];
-    if (!contentId) {
-      console.error("Usage: autocrew versions <content-id>");
+    const id = args[0];
+    if (!id) {
+      console.error("Usage: autocrew versions <project-slug-or-content-id>");
       process.exitCode = 1;
       return;
     }
-    const result = await runner.execute("autocrew_asset", { action: "versions", content_id: contentId });
+
+    // Try pipeline project first (draft versions from meta.yaml)
+    try {
+      const pipelineResult = await runner.execute("autocrew_pipeline_ops", {
+        action: "status",
+      });
+      // Search for project in pipeline stages
+      const { getProjectMeta } = await import("../../storage/pipeline-store.js");
+      const meta = await getProjectMeta(id);
+      if (meta) {
+        console.log(`Draft versions for "${meta.title}":`);
+        console.log(`  Current: ${meta.current}`);
+        if (meta.versions.length === 0) {
+          console.log("  No revision history yet (initial draft only).");
+        } else {
+          for (const v of meta.versions) {
+            console.log(`  ${v.file} — ${v.note} (${v.createdAt})`);
+          }
+        }
+        console.log(`  Stage: ${meta.history.at(-1)?.stage ?? "unknown"}`);
+        return;
+      }
+    } catch {
+      // Pipeline store may not be available
+    }
+
+    // Fallback to asset versions (legacy)
+    const result = await runner.execute("autocrew_asset", { action: "versions", content_id: id });
     const versions = (result.versions || []) as any[];
     if (versions.length === 0) {
-      console.log(`No versions for ${contentId}.`);
+      console.log(`No versions found for "${id}". Check the project slug or content ID.`);
       return;
     }
+    console.log(`Asset versions for ${id}:`);
     for (const v of versions) {
       console.log(`  v${v.version} — ${v.note || "no note"} (${v.savedAt})`);
     }

package/src/e2e.test.ts

@@ -181,6 +181,66 @@ describe("E2E: Topic Management", () => {
   });
 });
 
+describe("E2E: Topic → Start → Content (cross-system)", () => {
+  it("topic created via autocrew_topic can be started via pipeline_ops", async () => {
+    // Create topic via local-store (autocrew_topic)
+    const topicResult = await runner.execute("autocrew_topic", {
+      action: "create",
+      title: "端到端测试选题",
+      description: "测试从 topic 到 project 的完整流程",
+      tags: ["test"],
+    });
+    expect(topicResult.ok).toBe(true);
+    const topicId = (topicResult.topic as any).id;
+    expect(topicId).toBeDefined();
+
+    // Start project via pipeline-store (should find the legacy topic)
+    const startResult = await runner.execute("autocrew_pipeline_ops", {
+      action: "start",
+      project: topicId,
+    });
+    expect(startResult.ok).toBe(true);
+    expect(startResult.projectDir).toBeDefined();
+    // Should return next step guidance
+    expect(startResult.nextStep).toBeDefined();
+    expect((startResult.nextStep as string)).toContain("autocrew_content");
+  });
+
+  it("content list returns both legacy contents and pipeline projects", async () => {
+    const result = await runner.execute("autocrew_content", { action: "list" });
+    expect(result.ok).toBe(true);
+    // Should have legacy contents from earlier tests
+    expect(result.contents).toBeDefined();
+    // Should have pipeline projects from start test above
+    expect(result.pipelineProjects).toBeDefined();
+    const projects = result.pipelineProjects as any[];
+    expect(projects.length).toBeGreaterThanOrEqual(1);
+  });
+
+  it("research auto mode does not return placeholder topics", async () => {
+    const result = await runner.execute("autocrew_research", {
+      action: "discover",
+      keyword: "测试关键词",
+      mode: "auto",
+      topic_count: 3,
+      save_topics: false,
+    });
+    // Should either return real results or a proper error — never fake placeholders
+    if (result.ok) {
+      const topics = (result.topics || []) as any[];
+      for (const t of topics) {
+        // No topic should contain "API 候选" placeholder text
+        expect(t.title).not.toContain("API 候选");
+        expect(t.title).not.toContain("候选");
+      }
+    } else {
+      // Error is acceptable — it means no source worked, but at least it's honest
+      expect(result.error).toBeDefined();
+      expect(result.suggestion).toBeDefined();
+    }
+  });
+});
+
 describe("E2E: Pipeline & Workflow", () => {
   let workflowId: string;
 

package/src/tools/pipeline-ops.ts

@@ -62,7 +62,16 @@ export async function executePipelineOps(params: Record<string, unknown>) {
         return { ok: false, error: "Missing 'project' — provide a topic slug to start from." };
       }
       const dir = await startProject(project, dataDir);
-      return { ok: true, action: "start", projectDir: dir };
+      return {
+        ok: true,
+        action: "start",
+        projectDir: dir,
+        nextStep:
+          "Project structure created with empty draft.md. " +
+          "NEXT: Write the content draft and save it using autocrew_content action='save' " +
+          "with title and body. The save action handles pipeline integration, version tracking, " +
+          "and auto-humanization. Do NOT use the Write tool to edit draft.md directly.",
+      };
     }
 
     case "advance": {

package/src/tools/registry.ts

@@ -47,8 +47,12 @@ export function registerAllTools(runner: ToolRunner): void {
     name: "autocrew_content",
     label: "AutoCrew Content",
     description:
-      "Manage content lifecycle: save drafts, list/get/update content, transition status, manage siblings and variants. " +
-      "Actions: save, list, get, update, transition, list_siblings, create_variant.",
+      "Content creation and lifecycle management. THIS IS THE PRIMARY CONTENT CREATION TOOL. " +
+      "To create content: use action='save' with title and body (the full draft text). " +
+      "The tool handles pipeline project creation, version tracking, and auto-humanization. " +
+      "Workflow: 1) Research with autocrew_intel, 2) Write the full draft body, " +
+      "3) Save with autocrew_content action='save' (title, body, platform, hypothesis, tags). " +
+      "Other actions: list, get, update, transition, create_variant, siblings, allowed_transitions.",
     parameters: contentSaveSchema,
     execute: executeContentSave,
   });
@@ -145,8 +149,10 @@ export function registerAllTools(runner: ToolRunner): void {
     name: "autocrew_intel",
     label: "AutoCrew 灵感源",
     description:
-      "Inspiration source pipeline. Actions: pull (collect from web/RSS/trends), " +
-      "list (show saved), clean (archive expired), ingest (manually add url/text/memory).",
+      "Content research and inspiration pipeline. Use this BEFORE writing content to gather real data, " +
+      "case studies, and trends. Actions: pull (collect from web search/RSS/trends — primary research tool), " +
+      "list (show saved intel), clean (archive expired), ingest (manually add url/text/memory sources). " +
+      "Research results feed into the knowledge wiki and are referenced during content creation.",
     parameters: intelSchema,
     execute: executeIntel,
   });
@@ -155,7 +161,9 @@ export function registerAllTools(runner: ToolRunner): void {
     name: "autocrew_pipeline_ops",
     label: "AutoCrew Pipeline Ops",
     description:
-      "Content pipeline lifecycle management. Actions: status (stage counts), start (topic→project), advance (next stage), version (add draft), trash, restore.",
+      "Content pipeline lifecycle management. Actions: status (stage counts), start (topic→project — creates project structure, NOT content), " +
+      "advance (next stage — requires draft.md with ≥100 chars), version (add draft revision), trash, restore. " +
+      "NOTE: 'start' only creates the project folder. To create actual content, use autocrew_content action='save' with the full draft body.",
     parameters: pipelineOpsSchema,
     execute: executePipelineOps,
   });