centy 0.8.0 → 0.8.1

package/dist/lib/list-items/handle-project-list.js

@@ -0,0 +1,44 @@
+import { daemonListItems } from '../../daemon/daemon-list-items.js';
+import { ensureInitialized, NotInitializedError, } from '../../utils/ensure-initialized.js';
+export async function handleProjectList(cwd, itemType, filter, limit, offset, jsonMode, log, error) {
+    try {
+        await ensureInitialized(cwd);
+    }
+    catch (err) {
+        if (err instanceof NotInitializedError) {
+            error(err.message);
+        }
+        throw err instanceof Error ? err : new Error(String(err));
+    }
+    const response = await daemonListItems({
+        projectPath: cwd,
+        itemType,
+        filter,
+        limit,
+        offset,
+    });
+    if (!response.success) {
+        error(response.error);
+    }
+    if (jsonMode) {
+        log(JSON.stringify(response.items, null, 2));
+        return;
+    }
+    if (response.items.length === 0) {
+        log(`No ${itemType} found.`);
+        return;
+    }
+    log(`Found ${response.totalCount} ${itemType}:\n`);
+    for (const item of response.items) {
+        const meta = item.metadata;
+        if (meta === undefined) {
+            log(item.title);
+            continue;
+        }
+        const dn = meta.displayNumber > 0 ? `#${meta.displayNumber} ` : '';
+        const status = meta.status !== '' ? ` [${meta.status}]` : '';
+        const priority = meta.priority > 0 ? ` [P${meta.priority}]` : '';
+        log(`${dn}${item.title}${status}${priority}`);
+    }
+}
+//# sourceMappingURL=handle-project-list.js.map

package/dist/lib/list-items/handle-project-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-project-list.js","sourceRoot":"","sources":["../../../src/lib/list-items/handle-project-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,mCAAmC,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,QAAgB,EAChB,MAAc,EACd,KAAa,EACb,MAAc,EACd,QAAiB,EACjB,GAA0B,EAC1B,KAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YACvC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC;QACrC,WAAW,EAAE,GAAG;QAChB,QAAQ;QACR,MAAM;QACN,KAAK;QACL,MAAM;KACP,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC5C,OAAM;IACR,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,MAAM,QAAQ,SAAS,CAAC,CAAA;QAC5B,OAAM;IACR,CAAC;IAED,GAAG,CAAC,SAAS,QAAQ,CAAC,UAAU,IAAI,QAAQ,KAAK,CAAC,CAAA;IAClD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC1B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAChE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC"}

package/dist/lib/show/format-results.d.ts

@@ -1,3 +1,3 @@
-import type { IssueWithProject } from '../../daemon/types.js';
-export declare function formatIssueResults(issues: IssueWithProject[], log: (msg: string) => void): void;
+import type { ItemWithProject } from '../../daemon/types.js';
+export declare function formatIssueResults(issues: ItemWithProject[], log: (msg: string) => void): void;
 //# sourceMappingURL=format-results.d.ts.map

package/dist/lib/show/format-results.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-results.d.ts","sourceRoot":"","sources":["../../../src/lib/show/format-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,IAAI,CAmBN"}
+{"version":3,"file":"format-results.d.ts","sourceRoot":"","sources":["../../../src/lib/show/format-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,eAAe,EAAE,EACzB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,IAAI,CAiBN"}

package/dist/lib/show/format-results.js

@@ -1,17 +1,17 @@
 export function formatIssueResults(issues, log) {
     for (const iwp of issues) {
-        const issue = iwp.issue;
+        const issue = iwp.item;
         const meta = issue.metadata;
         log(`--- Project: ${iwp.projectName} (${iwp.projectPath}) ---`);
-        log(`Issue #${issue.displayNumber}`);
+        log(`Issue #${meta !== undefined ? meta.displayNumber : 0}`);
         log(`ID: ${issue.id}`);
         log(`Title: ${issue.title}`);
         log(`Status: ${meta !== undefined ? meta.status : 'unknown'}`);
-        log(`Priority: ${meta !== undefined ? (meta.priorityLabel !== '' ? meta.priorityLabel : `P${meta.priority}`) : 'P?'}`);
+        log(`Priority: ${meta !== undefined ? `P${meta.priority}` : 'P?'}`);
         log(`Created: ${meta !== undefined ? meta.createdAt : 'unknown'}`);
         log(`Updated: ${meta !== undefined ? meta.updatedAt : 'unknown'}`);
-        if (issue.description) {
-            log(`\nDescription:\n${issue.description}`);
+        if (issue.body) {
+            log(`\nDescription:\n${issue.body}`);
         }
         log('');
     }

package/dist/lib/show/format-results.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-results.js","sourceRoot":"","sources":["../../../src/lib/show/format-results.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,MAA0B,EAC1B,GAA0B;IAE1B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAM,CAAA;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAA;QAC3B,GAAG,CAAC,gBAAgB,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC,WAAW,OAAO,CAAC,CAAA;QAC/D,GAAG,CAAC,UAAU,KAAK,CAAC,aAAa,EAAE,CAAC,CAAA;QACpC,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QACtB,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5B,GAAG,CAAC,WAAW,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAC9D,GAAG,CACD,aAAa,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAClH,CAAA;QACD,GAAG,CAAC,YAAY,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAClE,GAAG,CAAC,YAAY,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAClE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,GAAG,CAAC,mBAAmB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;QAC7C,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,CAAA;IACT,CAAC;AACH,CAAC"}
+{"version":3,"file":"format-results.js","sourceRoot":"","sources":["../../../src/lib/show/format-results.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,GAA0B;IAE1B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAK,CAAA;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAA;QAC3B,GAAG,CAAC,gBAAgB,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC,WAAW,OAAO,CAAC,CAAA;QAC/D,GAAG,CAAC,UAAU,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC5D,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QACtB,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5B,GAAG,CAAC,WAAW,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAC9D,GAAG,CAAC,aAAa,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACnE,GAAG,CAAC,YAAY,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAClE,GAAG,CAAC,YAAY,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAA;QAClE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,mBAAmB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACtC,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,CAAA;IACT,CAAC;AACH,CAAC"}

package/dist/lib/show/search-entities.d.ts

@@ -1,6 +1,6 @@
-import type { GetIssuesByUuidResponse } from '../../daemon/types.js';
+import type { SearchItemsResponse } from '../../daemon/types.js';
 export interface EntitySearchResult {
-    issuesResult: GetIssuesByUuidResponse;
+    issuesResult: SearchItemsResponse;
 }
 export declare function searchEntitiesByUuid(uuid: string): Promise<EntitySearchResult>;
 //# sourceMappingURL=search-entities.d.ts.map

package/dist/lib/show/search-entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-entities.d.ts","sourceRoot":"","sources":["../../../src/lib/show/search-entities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,uBAAuB,CAAA;CACtC;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}
+{"version":3,"file":"search-entities.d.ts","sourceRoot":"","sources":["../../../src/lib/show/search-entities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,mBAAmB,CAAA;CAClC;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}

package/dist/utils/apply-link-flags.d.ts

@@ -0,0 +1,10 @@
+interface Logger {
+    log(msg: string): void;
+    warn(msg: string): void;
+}
+/**
+ * Process --link flag specs and create links for a newly created/updated item.
+ */
+export declare function applyLinkFlags(linkSpecs: string[], sourceId: string, sourceType: string, projectPath: string, logger: Logger): Promise<void>;
+export {};
+//# sourceMappingURL=apply-link-flags.d.ts.map

package/dist/utils/apply-link-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-link-flags.d.ts","sourceRoot":"","sources":["../../src/utils/apply-link-flags.ts"],"names":[],"mappings":"AAIA,UAAU,MAAM;IACd,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/utils/apply-link-flags.js

@@ -0,0 +1,37 @@
+import { daemonCreateLink } from '../daemon/daemon-create-link.js';
+import { parseLinkTarget } from './parse-link-target.js';
+/**
+ * Process --link flag specs and create links for a newly created/updated item.
+ */
+export async function applyLinkFlags(linkSpecs, sourceId, sourceType, projectPath, logger) {
+    for (const linkSpec of linkSpecs) {
+        const colonIdx = linkSpec.indexOf(':');
+        if (colonIdx === -1) {
+            logger.warn(`Invalid link format "${linkSpec}" — expected link-type:type:id`);
+            continue;
+        }
+        const linkType = linkSpec.slice(0, colonIdx);
+        const parsed = parseLinkTarget(linkSpec.slice(colonIdx + 1));
+        if (parsed === undefined) {
+            logger.warn(`Invalid link target in "${linkSpec}" — expected type:id`);
+            continue;
+        }
+        const linkResp = await daemonCreateLink({
+            projectPath,
+            sourceId,
+            // eslint-disable-next-line no-restricted-syntax
+            sourceType: sourceType,
+            targetId: parsed[1],
+            // eslint-disable-next-line no-restricted-syntax
+            targetType: parsed[0],
+            linkType,
+        });
+        if (!linkResp.success) {
+            logger.warn(`Failed to create link "${linkSpec}": ${linkResp.error}`);
+        }
+        else {
+            logger.log(`  Linked: ${sourceType} --[${linkType}]--> ${parsed[0]}:${parsed[1]}`);
+        }
+    }
+}
+//# sourceMappingURL=apply-link-flags.js.map

package/dist/utils/apply-link-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-link-flags.js","sourceRoot":"","sources":["../../src/utils/apply-link-flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAElE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAOxD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAmB,EACnB,QAAgB,EAChB,UAAkB,EAClB,WAAmB,EACnB,MAAc;IAEd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CACT,wBAAwB,QAAQ,gCAAgC,CACjE,CAAA;YACD,SAAQ;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,2BAA2B,QAAQ,sBAAsB,CAAC,CAAA;YACtE,SAAQ;QACV,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC;YACtC,WAAW;YACX,QAAQ;YACR,gDAAgD;YAChD,UAAU,EAAE,UAA4B;YACxC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACnB,gDAAgD;YAChD,UAAU,EAAE,MAAM,CAAC,CAAC,CAAmB;YACvC,QAAQ;SACT,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;QACvE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CACR,aAAa,UAAU,OAAO,QAAQ,QAAQ,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CACvE,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/oclif.manifest.json

@@ -79,10 +79,7 @@
       "args": {},
       "description": "Compact uncompacted issues into feature summaries",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dry-run",
-        "<%= config.bin %> <%= command.id %> --output context.md",
-        "<%= config.bin %> <%= command.id %> --input response.md --project centy-daemon"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
         "dry-run": {
@@ -191,7 +188,9 @@
         "<%= config.bin %> create doc --title \"Getting Started\" --body \"# Guide\"",
         "<%= config.bin %> create epic --title \"Auth overhaul\" --status open",
         "<%= config.bin %> create bug --title \"Crash on startup\"",
-        "<%= config.bin %> create task --title \"Review PR\" --custom-field \"assignee=alice\""
+        "<%= config.bin %> create task --title \"Review PR\" --custom-field \"assignee=alice\"",
+        "<%= config.bin %> create issue --title \"Login crash\" --link blocks:issue:2",
+        "<%= config.bin %> create task --title \"Write tests\" --link relates-to:issue:5 --link relates-to:doc:api-guide"
       ],
       "flags": {
         "title": {
@@ -237,6 +236,13 @@
           "multiple": true,
           "type": "option"
         },
+        "link": {
+          "description": "Link to another entity as link-type:type:id (repeatable, e.g. blocks:issue:2)",
+          "name": "link",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "json": {
           "description": "Output as JSON",
           "name": "json",
@@ -391,6 +397,103 @@
         "duplicate.js"
       ]
     },
+    "edit": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Item type (e.g., issue, epic, or custom type)",
+          "name": "type",
+          "required": true
+        },
+        "id": {
+          "description": "Item ID (UUID, display number, or slug)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Alias for `update`. Update an item by type and identifier",
+      "examples": [
+        "<%= config.bin %> edit issue 1 --status closed",
+        "<%= config.bin %> edit epic 1 --title \"New title\"",
+        "<%= config.bin %> edit bug abc123-uuid --status in-progress --priority 1",
+        "<%= config.bin %> edit issue 1 --project centy-daemon"
+      ],
+      "flags": {
+        "title": {
+          "char": "t",
+          "description": "New title",
+          "name": "title",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "body": {
+          "char": "b",
+          "description": "New body (markdown content)",
+          "name": "body",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "char": "s",
+          "description": "New status (e.g., open, in-progress, closed)",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "priority": {
+          "char": "p",
+          "description": "New priority level (1 = highest)",
+          "name": "priority",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "custom-field": {
+          "description": "Custom field in key=value format (repeatable)",
+          "name": "custom-field",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "link": {
+          "description": "Link to another entity as link-type:type:id (repeatable, e.g. blocks:issue:2)",
+          "name": "link",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "description": "Project name or path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "edit",
+      "pluginAlias": "centy",
+      "pluginName": "centy",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "edit.js"
+      ]
+    },
     "get": {
       "aliases": [],
       "args": {
@@ -661,12 +764,9 @@
       "description": "List items of any type",
       "examples": [
         "<%= config.bin %> list issues",
-        "<%= config.bin %> list epics",
         "<%= config.bin %> list epics --status open",
-        "<%= config.bin %> list epics --priority 1",
-        "<%= config.bin %> list bugs --json",
-        "<%= config.bin %> list bugs --json --limit 10",
-        "<%= config.bin %> list issues --project centy-daemon"
+        "<%= config.bin %> list issues --global",
+        "<%= config.bin %> list issues --global --status open --json"
       ],
       "flags": {
         "status": {
@@ -714,6 +814,13 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "global": {
+          "char": "g",
+          "description": "List items across all tracked projects",
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "project": {
           "description": "Project name or path (defaults to current directory)",
           "name": "project",
@@ -876,6 +983,61 @@
         "move.js"
       ]
     },
+    "next": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Item type (e.g., issue, bug, epic, or custom type)",
+          "name": "type",
+          "required": true
+        }
+      },
+      "description": "Get the next open item of any type",
+      "examples": [
+        "<%= config.bin %> next issue",
+        "<%= config.bin %> next issue --status in-progress",
+        "<%= config.bin %> next bug --json",
+        "<%= config.bin %> next issue --project centy-daemon"
+      ],
+      "flags": {
+        "status": {
+          "char": "s",
+          "description": "Filter by status (e.g., open, in-progress, closed)",
+          "name": "status",
+          "default": "open",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "description": "Project name or path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "next",
+      "pluginAlias": "centy",
+      "pluginName": "centy",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "next.js"
+      ]
+    },
     "restart": {
       "aliases": [],
       "args": {},
@@ -1167,7 +1329,8 @@
         "<%= config.bin %> update issue 1 --status closed",
         "<%= config.bin %> update epic 1 --title \"New title\"",
         "<%= config.bin %> update bug abc123-uuid --status in-progress --priority 1",
-        "<%= config.bin %> update epic 1 --project centy-daemon"
+        "<%= config.bin %> update epic 1 --project centy-daemon",
+        "<%= config.bin %> update issue 1 --status closed --link blocks:issue:2"
       ],
       "flags": {
         "title": {
@@ -1209,6 +1372,13 @@
           "multiple": true,
           "type": "option"
         },
+        "link": {
+          "description": "Link to another entity as link-type:type:id (repeatable, e.g. blocks:issue:2)",
+          "name": "link",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "json": {
           "description": "Output as JSON",
           "name": "json",
@@ -1652,7 +1822,7 @@
         },
         "features": {
           "char": "f",
-          "description": "Comma-separated features (display-number, status, priority, assets, org-sync, move, duplicate)",
+          "description": "Comma-separated features (display-number, status, priority, assets, org-sync, move, duplicate, soft-delete)",
           "name": "features",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -1786,6 +1956,83 @@
         "assets.js"
       ]
     },
+    "list:items": {
+      "aliases": [],
+      "args": {
+        "type": {
+          "description": "Item type (e.g., issues, docs, bugs)",
+          "name": "type",
+          "required": true
+        }
+      },
+      "description": "List items of any type",
+      "examples": [
+        "<%= config.bin %> list issues",
+        "<%= config.bin %> list issues --status open --priority 1",
+        "<%= config.bin %> list docs --json --limit 10",
+        "<%= config.bin %> list bugs --project centy-daemon"
+      ],
+      "flags": {
+        "status": {
+          "description": "Filter by status",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "priority": {
+          "description": "Filter by priority level",
+          "name": "priority",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Limit number of results (0 = no limit)",
+          "name": "limit",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Offset for pagination",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project": {
+          "description": "Project name or path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "list:items",
+      "pluginAlias": "centy",
+      "pluginName": "centy",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "list",
+        "items.js"
+      ]
+    },
     "list:link-types": {
       "aliases": [],
       "args": {},
@@ -2960,5 +3207,5 @@
       ]
     }
   },
-  "version": "0.8.0"
+  "version": "0.8.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "centy",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "CLI for managing project issues and docs via code in the .centy folder",
   "type": "module",
   "main": "./dist/index.js",

package/proto/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm cspell --no-progress "**"

package/proto/README.md

@@ -0,0 +1,19 @@
+# centy-io/proto
+
+Protocol Buffer definitions for the Centy daemon gRPC API.
+
+## Consuming this repo
+
+This repository is intended to be consumed as a git submodule:
+
+```sh
+git submodule add https://github.com/centy-io/proto proto
+```
+
+## Structure
+
+```
+centy/v1/
+  centy.proto        # CentyDaemon service and message types
+  generic_item.proto # Shared generic item messages
+```