@tuongaz/seeflow 0.1.83 → 0.1.84

package/src/cli.ts

@@ -178,6 +178,8 @@ if (argv.includes('--version') || argv.includes('-v')) {
   await runRegister();
 } else if (sub === 'projects:create') {
   await runProjectsCreate();
+} else if (sub === 'projects:list') {
+  await runProjectsList();
 } else if (sub === 'flows:list') {
   await runFlowsList();
 } else if (sub === 'flows:summary') {
@@ -243,10 +245,11 @@ Usage:
 Commands (work without a running studio):
   start                Start the SeeFlow Studio server (default port 4321) — default when no command is given
   stop                 Stop a background studio instance
-  register             Register a demo repo, writing to ~/.seeflow/registry.json (alias of flows:register)
-  flows:register       Register a demo repo
+  register             Register a demo repo. Manifest-aware: when <repoPath>/seeflow.json exists, re-scans every declared flow; otherwise reads <repoPath>/<flow> (defaults to flow.json) as a single-flow project (alias of flows:register)
+  flows:register       Register a demo repo (manifest-aware — same behaviour as register)
   projects:create      Scaffold a new project (writes <path>/seeflow.json + <path>/flows/main/flow.json) — (--path <dir> --name <name> [--description <text>])
-  flows:list           List registered flows
+  projects:list        List every registered project with projectSlug, name, defaultFlow, flowCount
+  flows:list           List registered flows. With --project <p>, filters to one project (returns flowSlug, name, icon?, isDefault per flow)
   flows:summary        List registered flows (id + name + description only)
   flows:get            Get flow details (--project <p> --flow <f>)
   flows:graph          List nodes + connectors without inlined file content (--project <p> --flow <f>)
@@ -594,12 +597,24 @@ function isEsrch(err: unknown): boolean {
 
 async function runRegister() {
   const repoPath = resolve(flagValue('path') ?? '.');
-  const demoPathArg = flagValue('flow') ?? DEFAULT_FLOW_PATH;
 
+  // Manifest-aware path: if <repoPath>/seeflow.json is on disk, scan and
+  // upsert every declared flow in one shot.
+  if (existsSync(join(repoPath, 'seeflow.json'))) {
+    await runRegisterManifest(repoPath);
+    return;
+  }
+
+  // Legacy single-flow path: pre-manifest projects (and skill tests that
+  // exercise registerFlow directly) still pass a bare flow.json at the
+  // root. Read it, schema-validate, upsert one entry.
+  const demoPathArg = flagValue('flow') ?? DEFAULT_FLOW_PATH;
   const fullPath = isAbsolute(demoPathArg) ? demoPathArg : join(repoPath, demoPathArg);
   if (!existsSync(fullPath)) {
     console.error(`No demo file at ${fullPath}`);
-    console.error(`Create ${DEFAULT_FLOW_PATH} in your repo, or pass --flow <path>.`);
+    console.error(
+      `Create ${DEFAULT_FLOW_PATH} in your repo, or pass --flow <path>. For manifest-driven projects, place a seeflow.json at the repo root.`,
+    );
     process.exit(1);
   }
 
@@ -643,6 +658,48 @@ async function runRegister() {
   }
 }
 
+async function runRegisterManifest(repoPath: string) {
+  const outcome = registerProject({ repoPath });
+  if (outcome.kind !== 'ok') {
+    switch (outcome.kind) {
+      case 'manifest-invalid':
+        console.error(`${join(repoPath, 'seeflow.json')} is invalid: ${outcome.message}`);
+        process.exit(2);
+        break;
+      case 'manifest-missing':
+        // Defensive — runRegister gated on existsSync, so this should not fire.
+        console.error(`No seeflow.json at ${repoPath}`);
+        process.exit(3);
+        break;
+      case 'legacy-root-flow':
+        console.error(
+          `${repoPath} has a legacy root flow.json but no seeflow.json. Migrate it into the new flows/<id>/ layout before re-registering.`,
+        );
+        process.exit(3);
+        break;
+      case 'flow-json-missing':
+        console.error(
+          `Manifest declares flow "${outcome.flowId}" but ${outcome.flowPath} is missing.`,
+        );
+        process.exit(3);
+        break;
+    }
+    process.exit(1);
+  }
+
+  const pid = readPid();
+  const live = pid !== undefined && isPidAlive(pid);
+  const overrideUrl = process.env.SEEFLOW_STUDIO_URL?.replace(/\/+$/, '');
+  const baseUrl = live ? (overrideUrl ?? studioUrl(readConfig())) : null;
+
+  for (const entry of outcome.entries) {
+    const tail = baseUrl
+      ? ` → ${baseUrl}/projects/${outcome.projectSlug}/flows/${entry.flowSlug}`
+      : ` (slug: ${entry.slug})`;
+    console.log(`Registered "${entry.name}"${tail}`);
+  }
+}
+
 async function ensureStudioRunning(url: string, port: number, noStart: boolean) {
   if (await healthOk(url)) return;
 
@@ -709,10 +766,23 @@ async function runProjectsCreate() {
 
 async function runFlowsList() {
   const ops = createCliOperations();
+  const project = flagValue('project');
+  if (project) {
+    const result = ops.listFlowsByProject(project);
+    if (result.kind !== 'ok') printOutcome(result);
+    printOk({ projectSlug: result.data.projectSlug, flows: result.data.flows });
+    return;
+  }
   const result = ops.listFlows();
   printOk({ flows: result.data });
 }
 
+function runProjectsList() {
+  const ops = createCliOperations();
+  const result = ops.listProjects();
+  printOk({ projects: result.data });
+}
+
 async function runFlowsSummary() {
   const ops = createCliOperations();
   const result = ops.listFlowsSummary();

package/src/operations.ts

@@ -22,8 +22,8 @@ import {
   removeNodeDir,
   writeNodeFile,
 } from './node-files.ts';
-import { scanProject } from './project-scanner.ts';
-import { type Registry, slugify } from './registry.ts';
+import { readProjectManifest, scanProject } from './project-scanner.ts';
+import { type FlowEntry, type Registry, slugify } from './registry.ts';
 import {
   ColorTokenSchema,
   ComponentSpecSchema,
@@ -404,6 +404,31 @@ export interface CreateProjectSuccess {
 
 export type ListFlowsOutcome = { kind: 'ok'; data: FlowListItem[] };
 
+export interface ProjectListItem {
+  projectSlug: string;
+  name: string;
+  description?: string;
+  defaultFlow: string;
+  flowCount: number;
+  repoPath: string;
+}
+
+export type ListProjectsOutcome = { kind: 'ok'; data: ProjectListItem[] };
+
+export interface ProjectFlowListItem {
+  id: string;
+  slug: string;
+  flowSlug: string;
+  name: string;
+  icon?: string;
+  isDefault: boolean;
+  valid: boolean;
+}
+
+export type ListFlowsByProjectOutcome =
+  | { kind: 'ok'; data: { projectSlug: string; flows: ProjectFlowListItem[] } }
+  | { kind: 'projectNotFound'; projectSlug: string };
+
 // Minimal projection for agent/CLI discovery — `description` and `name` come
 // from the live watcher snapshot when available so author edits to flow.json
 // surface immediately; fall back to the registry value at startup before
@@ -951,6 +976,52 @@ export function listDemosImpl(deps: OperationsDeps): ListFlowsOutcome {
   return { kind: 'ok', data };
 }
 
+export function listProjectsImpl(deps: OperationsDeps): ListProjectsOutcome {
+  const grouped = new Map<string, FlowEntry[]>();
+  for (const entry of deps.registry.list()) {
+    const existing = grouped.get(entry.projectSlug);
+    if (existing) existing.push(entry);
+    else grouped.set(entry.projectSlug, [entry]);
+  }
+  const data: ProjectListItem[] = [];
+  for (const [projectSlug, entries] of grouped) {
+    const head = entries[0];
+    if (!head) continue;
+    const manifest = readProjectManifest(head.repoPath);
+    const defaultEntry = entries.find((e) => e.isDefault) ?? head;
+    data.push({
+      projectSlug,
+      name: manifest?.name ?? projectSlug,
+      ...(manifest?.description !== undefined ? { description: manifest.description } : {}),
+      defaultFlow: manifest?.defaultFlow ?? defaultEntry.flowSlug,
+      flowCount: entries.length,
+      repoPath: head.repoPath,
+    });
+  }
+  return { kind: 'ok', data };
+}
+
+export function listFlowsByProjectImpl(
+  deps: OperationsDeps,
+  projectSlug: string,
+): ListFlowsByProjectOutcome {
+  const entries = deps.registry.list().filter((e) => e.projectSlug === projectSlug);
+  if (entries.length === 0) return { kind: 'projectNotFound', projectSlug };
+  const flows: ProjectFlowListItem[] = entries.map((e) => {
+    const fileExists = existsSync(resolveFilePath(e.repoPath, e.flowPath));
+    return {
+      id: e.id,
+      slug: e.slug,
+      flowSlug: e.flowSlug,
+      name: e.name,
+      ...(e.icon !== undefined ? { icon: e.icon } : {}),
+      isDefault: e.isDefault,
+      valid: e.valid && fileExists,
+    };
+  });
+  return { kind: 'ok', data: { projectSlug, flows } };
+}
+
 export function listFlowsSummaryImpl(deps: OperationsDeps): ListFlowsSummaryOutcome {
   const { registry, watcher } = deps;
   const data = registry.list().map((e) => {
@@ -1899,6 +1970,8 @@ export async function applyLayoutImpl(
 export interface Operations {
   listFlows(): ReturnType<typeof listDemosImpl>;
   listFlowsSummary(): ReturnType<typeof listFlowsSummaryImpl>;
+  listProjects(): ReturnType<typeof listProjectsImpl>;
+  listFlowsByProject(projectSlug: string): ReturnType<typeof listFlowsByProjectImpl>;
   getFlow(id: string): ReturnType<typeof getFlowImpl>;
   getFlowGraph(id: string): ReturnType<typeof getFlowGraphImpl>;
   getNode(flowId: string, nodeId: string): ReturnType<typeof getNodeImpl>;
@@ -1946,6 +2019,8 @@ export function createOperations(deps: OperationsDeps): Operations {
   return {
     listFlows: () => listDemosImpl(deps),
     listFlowsSummary: () => listFlowsSummaryImpl(deps),
+    listProjects: () => listProjectsImpl(deps),
+    listFlowsByProject: (projectSlug) => listFlowsByProjectImpl(deps, projectSlug),
     getFlow: (id) => getFlowImpl(deps, id),
     getFlowGraph: (id) => getFlowGraphImpl(deps, id),
     getNode: (flowId, nodeId) => getNodeImpl(deps, flowId, nodeId),

package/src/project-scanner.ts

@@ -47,6 +47,24 @@ export type ScanResult =
 const MANIFEST_FILENAME = 'seeflow.json';
 const LEGACY_FLOW_FILENAME = 'flow.json';
 
+/**
+ * Best-effort manifest read for listing routes / CLI listing verbs.
+ * Returns `null` when the manifest is missing or malformed — callers fall
+ * back to derived defaults (projectSlug, isDefault entry) so one broken
+ * project does not collapse the whole listing.
+ */
+export function readProjectManifest(repoPath: string): SeeflowManifest | null {
+  const manifestPath = join(repoPath, MANIFEST_FILENAME);
+  if (!existsSync(manifestPath)) return null;
+  try {
+    const raw = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const parsed = SeeflowManifestSchema.safeParse(raw);
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+
 export function scanProject(repoPath: string): ScanResult {
   const manifestPath = join(repoPath, MANIFEST_FILENAME);
   if (!existsSync(manifestPath)) {

package/dist/web/assets/channel-CXa0j4Re.js

@@ -1 +0,0 @@
-import{U as a,C as n}from"./mermaid.core-Cf2CUPpR.js";const t=(r,o)=>a.lang.round(n.parse(r)[o]);export{t as c};

package/dist/web/assets/classDiagram-4FO5ZUOK-DGPggFxp.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-DTQLQ_nx.js";import{a as i}from"./mermaid.core-Cf2CUPpR.js";import"./index-CaE1zYAX.js";import"./chunk-FMBD7UC4-Cqo28fuY.js";import"./chunk-ND2GUHAM-DcquCeO4.js";import"./chunk-55IACEB6-D_PUAOtb.js";import"./chunk-2J33WTMH-Cr7utMp9.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/web/assets/classDiagram-v2-Q7XG4LA2-DGPggFxp.js

@@ -1 +0,0 @@
-import{s as a,a as s,c as e,C as t}from"./chunk-727SXJPM-DTQLQ_nx.js";import{a as i}from"./mermaid.core-Cf2CUPpR.js";import"./index-CaE1zYAX.js";import"./chunk-FMBD7UC4-Cqo28fuY.js";import"./chunk-ND2GUHAM-DcquCeO4.js";import"./chunk-55IACEB6-D_PUAOtb.js";import"./chunk-2J33WTMH-Cr7utMp9.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var b={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{b as diagram};

package/dist/web/assets/stateDiagram-v2-BHNVJYJU-BCerI8Jf.js

@@ -1 +0,0 @@
-import{b as r,a as e,s as a,S as s}from"./chunk-AQP2D5EJ-OBgrFsDS.js";import{a as i}from"./mermaid.core-Cf2CUPpR.js";import"./index-CaE1zYAX.js";import"./chunk-55IACEB6-D_PUAOtb.js";import"./chunk-2J33WTMH-Cr7utMp9.js";import"./purify.es-CLGrRn1w.js";import"./step-CWvwoXpJ.js";var n={parser:a,get db(){return new s(2)},renderer:e,styles:r,init:i(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{n as diagram};