mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-05-14 00:23:04 +08:00
feat: add work items CLI
This commit is contained in:
Affaan Mustafa
committed by
Affaan Mustafa
Affaan Mustafa
parent
8926ea925e
commit
b1e67788f7
291
scripts/work-items.js
Normal file
291
scripts/work-items.js
Normal file
@@ -0,0 +1,291 @@
|
||||
#!/usr/bin/env node
|
||||
'use strict';
|
||||
|
||||
const os = require('os');
|
||||
const { createStateStore } = require('./lib/state-store');
|
||||
|
||||
const VALUE_FLAGS = new Set([
|
||||
'--db',
|
||||
'--id',
|
||||
'--limit',
|
||||
'--metadata-json',
|
||||
'--owner',
|
||||
'--priority',
|
||||
'--repo',
|
||||
'--repo-root',
|
||||
'--session',
|
||||
'--session-id',
|
||||
'--source',
|
||||
'--source-id',
|
||||
'--status',
|
||||
'--title',
|
||||
'--url',
|
||||
]);
|
||||
|
||||
function showHelp(exitCode = 0) {
|
||||
console.log(`
|
||||
Usage:
|
||||
node scripts/work-items.js list [--db <path>] [--json] [--limit <n>]
|
||||
node scripts/work-items.js show <id> [--db <path>] [--json]
|
||||
node scripts/work-items.js upsert [<id>] --title <title> [options] [--json]
|
||||
node scripts/work-items.js close <id> [--status done] [--db <path>] [--json]
|
||||
|
||||
Track Linear, GitHub, handoff, and manual roadmap items in the ECC SQLite state
|
||||
store so "ecc status" can include linked work and blocked operator follow-up.
|
||||
|
||||
Options:
|
||||
--id <id> Stable local work-item id for upsert
|
||||
--source <source> Source system, e.g. linear, github, handoff, manual
|
||||
--source-id <id> Source-local identifier, e.g. ECC-20 or PR number
|
||||
--status <status> Status such as open, in-progress, blocked, done
|
||||
--priority <priority> Optional priority label
|
||||
--url <url> Optional source URL
|
||||
--owner <owner> Optional owner label
|
||||
--repo-root <path> Optional repo root to associate with this item
|
||||
--repo <path> Alias for --repo-root
|
||||
--session-id <id> Optional ECC session id
|
||||
--session <id> Alias for --session-id
|
||||
--metadata-json <json> Optional JSON metadata payload
|
||||
--db <path> SQLite state database path
|
||||
--json Emit JSON
|
||||
`);
|
||||
process.exit(exitCode);
|
||||
}
|
||||
|
||||
function assignOption(options, flag, value) {
|
||||
if (flag === '--db') options.dbPath = value;
|
||||
else if (flag === '--id') options.id = value;
|
||||
else if (flag === '--limit') options.limit = value;
|
||||
else if (flag === '--metadata-json') options.metadataJson = value;
|
||||
else if (flag === '--owner') options.owner = value;
|
||||
else if (flag === '--priority') options.priority = value;
|
||||
else if (flag === '--repo' || flag === '--repo-root') options.repoRoot = value;
|
||||
else if (flag === '--session' || flag === '--session-id') options.sessionId = value;
|
||||
else if (flag === '--source') options.source = value;
|
||||
else if (flag === '--source-id') options.sourceId = value;
|
||||
else if (flag === '--status') options.status = value;
|
||||
else if (flag === '--title') options.title = value;
|
||||
else if (flag === '--url') options.url = value;
|
||||
else throw new Error(`Unknown argument: ${flag}`);
|
||||
}
|
||||
|
||||
function parseArgs(argv) {
|
||||
const args = argv.slice(2);
|
||||
const parsed = {
|
||||
command: 'list',
|
||||
dbPath: null,
|
||||
help: false,
|
||||
json: false,
|
||||
limit: 20,
|
||||
positionals: [],
|
||||
};
|
||||
|
||||
if (args[0] && !args[0].startsWith('-')) {
|
||||
parsed.command = args.shift();
|
||||
}
|
||||
|
||||
for (let index = 0; index < args.length; index += 1) {
|
||||
const arg = args[index];
|
||||
if (arg === '--help' || arg === '-h') {
|
||||
parsed.help = true;
|
||||
} else if (arg === '--json') {
|
||||
parsed.json = true;
|
||||
} else if (VALUE_FLAGS.has(arg)) {
|
||||
const value = args[index + 1];
|
||||
if (!value || value.startsWith('--')) {
|
||||
throw new Error(`Missing value for ${arg}`);
|
||||
}
|
||||
assignOption(parsed, arg, value);
|
||||
index += 1;
|
||||
} else if (!arg.startsWith('-')) {
|
||||
parsed.positionals.push(arg);
|
||||
} else {
|
||||
throw new Error(`Unknown argument: ${arg}`);
|
||||
}
|
||||
}
|
||||
|
||||
return parsed;
|
||||
}
|
||||
|
||||
function parseMetadataJson(value) {
|
||||
if (value === undefined || value === null) {
|
||||
return null;
|
||||
}
|
||||
|
||||
try {
|
||||
return JSON.parse(value);
|
||||
} catch (error) {
|
||||
throw new Error(`Invalid --metadata-json: ${error.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
function resolveWorkItemId(options) {
|
||||
return options.id || options.positionals[0] || null;
|
||||
}
|
||||
|
||||
function normalizeLimit(value) {
|
||||
const parsed = Number.parseInt(value, 10);
|
||||
if (!Number.isFinite(parsed) || parsed <= 0) {
|
||||
throw new Error(`Invalid limit: ${value}`);
|
||||
}
|
||||
return parsed;
|
||||
}
|
||||
|
||||
function buildUpsertPayload(options, existing = null) {
|
||||
const id = resolveWorkItemId(options);
|
||||
if (!id) {
|
||||
throw new Error('Missing work item id. Pass <id> or --id <id>.');
|
||||
}
|
||||
|
||||
const title = options.title ?? (existing && existing.title);
|
||||
if (!title) {
|
||||
throw new Error('Missing --title for a new work item.');
|
||||
}
|
||||
|
||||
return {
|
||||
id,
|
||||
source: options.source ?? (existing && existing.source) ?? 'manual',
|
||||
sourceId: options.sourceId ?? (existing && existing.sourceId) ?? null,
|
||||
title,
|
||||
status: options.status ?? (existing && existing.status) ?? 'open',
|
||||
priority: options.priority ?? (existing && existing.priority) ?? null,
|
||||
url: options.url ?? (existing && existing.url) ?? null,
|
||||
owner: options.owner ?? (existing && existing.owner) ?? null,
|
||||
repoRoot: options.repoRoot ?? (existing && existing.repoRoot) ?? process.cwd(),
|
||||
sessionId: options.sessionId ?? (existing && existing.sessionId) ?? null,
|
||||
metadata: options.metadataJson !== undefined
|
||||
? parseMetadataJson(options.metadataJson)
|
||||
: ((existing && existing.metadata) ?? null),
|
||||
createdAt: existing ? existing.createdAt : undefined,
|
||||
updatedAt: new Date().toISOString(),
|
||||
};
|
||||
}
|
||||
|
||||
function printWorkItem(item) {
|
||||
const sourceId = item.sourceId ? `#${item.sourceId}` : item.id;
|
||||
console.log(`${item.source}/${sourceId} ${item.status}: ${item.title}`);
|
||||
console.log(`ID: ${item.id}`);
|
||||
console.log(`Priority: ${item.priority || '(none)'}`);
|
||||
console.log(`Owner: ${item.owner || '(unassigned)'}`);
|
||||
console.log(`Repo: ${item.repoRoot || '(none)'}`);
|
||||
console.log(`Session: ${item.sessionId || '(none)'}`);
|
||||
console.log(`Updated: ${item.updatedAt}`);
|
||||
if (item.url) {
|
||||
console.log(`URL: ${item.url}`);
|
||||
}
|
||||
}
|
||||
|
||||
function printWorkItemList(payload) {
|
||||
console.log(`Work items: ${payload.items.length} shown / ${payload.totalCount} total`);
|
||||
if (payload.items.length === 0) {
|
||||
console.log(' - none');
|
||||
return;
|
||||
}
|
||||
|
||||
for (const item of payload.items) {
|
||||
const sourceId = item.sourceId ? `#${item.sourceId}` : item.id;
|
||||
console.log(` - ${item.source}/${sourceId} ${item.status}: ${item.title}`);
|
||||
console.log(` ID: ${item.id}`);
|
||||
console.log(` Owner: ${item.owner || '(unassigned)'}`);
|
||||
console.log(` Updated: ${item.updatedAt}`);
|
||||
if (item.url) {
|
||||
console.log(` URL: ${item.url}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
async function main() {
|
||||
let store = null;
|
||||
|
||||
try {
|
||||
const options = parseArgs(process.argv);
|
||||
if (options.help) {
|
||||
showHelp(0);
|
||||
}
|
||||
|
||||
store = await createStateStore({
|
||||
dbPath: options.dbPath,
|
||||
homeDir: process.env.HOME || os.homedir(),
|
||||
});
|
||||
|
||||
if (options.command === 'list') {
|
||||
const payload = store.listWorkItems({ limit: normalizeLimit(options.limit) });
|
||||
if (options.json) {
|
||||
console.log(JSON.stringify(payload, null, 2));
|
||||
} else {
|
||||
printWorkItemList(payload);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (options.command === 'show') {
|
||||
const id = resolveWorkItemId(options);
|
||||
if (!id) {
|
||||
throw new Error('Missing work item id.');
|
||||
}
|
||||
const item = store.getWorkItemById(id);
|
||||
if (!item) {
|
||||
throw new Error(`Work item not found: ${id}`);
|
||||
}
|
||||
if (options.json) {
|
||||
console.log(JSON.stringify(item, null, 2));
|
||||
} else {
|
||||
printWorkItem(item);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (options.command === 'upsert') {
|
||||
const id = resolveWorkItemId(options);
|
||||
const existing = id ? store.getWorkItemById(id) : null;
|
||||
const item = store.upsertWorkItem(buildUpsertPayload(options, existing));
|
||||
if (options.json) {
|
||||
console.log(JSON.stringify(item, null, 2));
|
||||
} else {
|
||||
printWorkItem(item);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (options.command === 'close') {
|
||||
const id = resolveWorkItemId(options);
|
||||
if (!id) {
|
||||
throw new Error('Missing work item id.');
|
||||
}
|
||||
const existing = store.getWorkItemById(id);
|
||||
if (!existing) {
|
||||
throw new Error(`Work item not found: ${id}`);
|
||||
}
|
||||
const item = store.upsertWorkItem(buildUpsertPayload({
|
||||
...options,
|
||||
id,
|
||||
status: options.status || 'done',
|
||||
}, existing));
|
||||
if (options.json) {
|
||||
console.log(JSON.stringify(item, null, 2));
|
||||
} else {
|
||||
printWorkItem(item);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
throw new Error(`Unknown command: ${options.command}`);
|
||||
} catch (error) {
|
||||
console.error(`Error: ${error.message}`);
|
||||
process.exit(1);
|
||||
} finally {
|
||||
if (store) {
|
||||
store.close();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (require.main === module) {
|
||||
main();
|
||||
}
|
||||
|
||||
module.exports = {
|
||||
buildUpsertPayload,
|
||||
main,
|
||||
parseArgs,
|
||||
};
|
||||
Reference in New Issue
Block a user