tenbo-dashboard 0.10.0 → 0.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tenbo-dashboard",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Local-first architecture dashboard and CLI tools for .tenbo/ repos",
   "type": "module",
   "license": "MIT",

package/scripts/bin-output.test.ts

@@ -56,4 +56,19 @@ describe('bin output', () => {
       { id: 'ed-001', title: 'Large Output', status: 'done' },
     ]);
   });
+
+  it('prints items help without running the query', () => {
+    const bin = path.resolve('bin/tenbo-dashboard.mjs');
+    const result = spawnSync(process.execPath, [bin, 'items', '--help'], {
+      cwd: dir,
+      encoding: 'utf8',
+      maxBuffer: 1024 * 1024,
+    });
+
+    expect(result.status).toBe(0);
+    expect(result.stderr).toBe('');
+    expect(result.stdout).toContain('Usage: tenbo-dashboard items');
+    expect(result.stdout).toContain('--fields <a,b>');
+    expect(result.stdout).not.toContain('ed-001');
+  });
 });

package/scripts/items.test.ts

@@ -82,6 +82,26 @@ describe('items CLI', () => {
     ]);
   });
 
+  it('includes goal_ref in selected compact fields', () => {
+    writeFileSync(path.join(dir, '.tenbo/scopes/editor/roadmap.yaml'), [
+      'items:',
+      '  - id: ed-001',
+      '    title: First',
+      '    layer: app',
+      '    status: next',
+      '    description: first item',
+      '    goal_ref: [g1, g2]',
+      '',
+    ].join('\n'));
+
+    const result = runItemsCli(dir, ['--fields', 'id,title,goal_ref', '--json']);
+
+    expect(result.exitCode).toBe(0);
+    expect(JSON.parse(result.stdout).items).toEqual([
+      { id: 'ed-001', title: 'First', goal_ref: ['g1', 'g2'] },
+    ]);
+  });
+
   it('returns compact summaries without changing full JSON by default', () => {
     const summary = runItemsCli(dir, ['--status', 'next', '--summary', '--json']);
     const full = runItemsCli(dir, ['--status', 'next', '--json']);

package/scripts/items.ts

@@ -1,9 +1,11 @@
 import { listItems, type ListItemFilters } from '../src/api/lib/roadmapStore';
 import { parseItemFields, projectItem, summarizeItem } from '../src/api/lib/itemProjection';
 import { hasFlag, readOption } from './cliArgs';
-import { handleCliError, isMain, misuse, repoRootFromCwd, runMain, serialize, type CliResult } from './cliResult';
+import { handleCliError, isMain, misuse, ok, repoRootFromCwd, runMain, serialize, type CliResult } from './cliResult';
 
 const STATUSES = new Set(['now', 'next', 'later', 'done', 'dropped']);
+const USAGE = `Usage: tenbo-dashboard items [--status <status[,status]>] [--verification <status>] [--goal <goal>] [--type <type>] [--priority <p0|p1|p2|p3>] [--layer <id>] [--fields <a,b>] [--summary] [--json]
+`;
 
 function readStatusFilter(value: string | undefined): ListItemFilters['status'] {
   if (!value) return undefined;
@@ -49,7 +51,8 @@ export function runItemsCli(repoRoot: string, args: string[]): CliResult {
 if (isMain(import.meta.url)) {
   const args = process.argv.slice(2);
   if (args.includes('--help')) {
-    runMain(fail('invalid_args', 'Usage: tenbo items [--status <status>] [--verification <status>] [--goal <goal>] [--json]', false));
+    runMain(ok(USAGE));
+  } else {
+    runMain(runItemsCli(repoRootFromCwd(), args));
   }
-  runMain(runItemsCli(repoRootFromCwd(), args));
 }

package/scripts/next-id.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect, afterEach } from 'vitest';
-import { mkdtempSync, mkdirSync, writeFileSync, rmSync, existsSync, readdirSync, utimesSync } from 'node:fs';
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync, readdirSync, utimesSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';

package/scripts/next-id.ts

@@ -27,7 +27,7 @@
  *   decoration so callers can capture it via `$(...)`. Errors go to stderr
  *   and the process exits non-zero.
  */
-import { readFileSync, existsSync, mkdirSync, readdirSync, writeFileSync, statSync, unlinkSync, openSync, closeSync, writeSync } from 'node:fs';
+import { readFileSync, existsSync, mkdirSync, statSync, unlinkSync, openSync, closeSync, writeSync } from 'node:fs';
 import path from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { findRepoRoot } from '../src/api/lib/repoRoot';
@@ -41,10 +41,6 @@ interface WorkspaceScope {
   path?: string;
 }
 
-interface RoadmapFile {
-  items?: Array<{ id?: string }>;
-}
-
 /** Find which roadmap.yaml files contain ids for this prefix. */
 export function resolveRoadmapPaths(repoRoot: string, prefix: string): string[] {
   const tenbo = path.join(repoRoot, '.tenbo');

package/src/api/lib/itemProjection.ts

@@ -10,6 +10,7 @@ export interface ItemSummaryRecord {
   layers?: string[];
   type?: Item['type'];
   priority?: Priority;
+  goal_ref?: Item['goal_ref'];
   verification?: VerificationStatus;
   risk_count?: number;
   done_when_count?: number;
@@ -25,6 +26,7 @@ export const ITEM_FIELD_NAMES = [
   'layers',
   'type',
   'priority',
+  'goal_ref',
   'verification',
   'risk_count',
   'done_when_count',
@@ -60,6 +62,7 @@ export function summarizeItem(entry: LocatedItem): ItemSummaryRecord {
     ...(item.layers ? { layers: item.layers } : {}),
     ...(item.type ? { type: item.type } : {}),
     ...(item.priority ? { priority: item.priority } : {}),
+    ...(item.goal_ref ? { goal_ref: item.goal_ref } : {}),
     ...(item.verification?.status ? { verification: item.verification.status } : {}),
     ...(item.risks ? { risk_count: item.risks.length } : {}),
     ...(item.done_when ? { done_when_count: item.done_when.length } : {}),

package/tsconfig.json

@@ -14,5 +14,5 @@
     "allowImportingTsExtensions": false,
     "noEmit": true
   },
-  "include": ["src", "tests", "vite.config.ts"]
+  "include": ["src", "tests", "scripts", "vite.config.ts"]
 }