@navels/neal 0.1.0

package/examples/issue-triage-js/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@navels/neal-example-issue-triage-js",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.5.0",
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/examples/issue-triage-js/src/issue-triage.js

@@ -0,0 +1,87 @@
+const ISSUE_LINE_PATTERN = /^- \[(P\d+)\] ([^:]+): (.+)$/;
+
+function incrementCounter(counter, key) {
+  counter[key] = (counter[key] ?? 0) + 1;
+}
+
+function formatCounts(title, counts) {
+  const lines = [`## ${title}`];
+
+  for (const [key, count] of Object.entries(counts)) {
+    lines.push(`- ${key}: ${count}`);
+  }
+
+  return lines.join('\n');
+}
+
+export function parseIssueLine(line) {
+  const match = line.match(ISSUE_LINE_PATTERN);
+
+  if (match === null) {
+    throw new Error(`Invalid issue line: ${line}`);
+  }
+
+  const [, priority, area, details] = match;
+  const tokens = details.split(' ');
+  const ownerToken = tokens.find((token) => token.startsWith('@'));
+  const tags = tokens
+    .filter((token) => token.startsWith('#'))
+    .map((token) => token.slice(1));
+  const title = tokens
+    .filter((token) => !token.startsWith('@') && !token.startsWith('#'))
+    .join(' ');
+
+  return {
+    priority,
+    area,
+    title,
+    owner: ownerToken?.slice(1) ?? null,
+    tags,
+  };
+}
+
+export function parseIssues(markdown) {
+  return markdown
+    .split(/\r?\n/u)
+    .map((line) => line.trimEnd())
+    .filter((line) => line.length > 0 && !line.startsWith('//'))
+    .map((line) => parseIssueLine(line));
+}
+
+export function summarizeIssues(issues) {
+  const summary = {
+    total: issues.length,
+    byPriority: {},
+    byArea: {},
+    byOwner: {},
+    byTag: {},
+  };
+
+  for (const issue of issues) {
+    incrementCounter(summary.byPriority, issue.priority);
+    incrementCounter(summary.byArea, issue.area);
+    incrementCounter(summary.byOwner, issue.owner);
+
+    for (const tag of issue.tags) {
+      incrementCounter(summary.byTag, tag);
+    }
+  }
+
+  return summary;
+}
+
+export function formatSummary(summary) {
+  return [
+    '# Issue Summary',
+    '',
+    `Total: ${summary.total}`,
+    '',
+    formatCounts('Priorities', summary.byPriority),
+    '',
+    formatCounts('Areas', summary.byArea),
+    '',
+    formatCounts('Owners', summary.byOwner),
+    '',
+    formatCounts('Tags', summary.byTag),
+  ].join('\n');
+}

package/examples/issue-triage-js/test/issue-triage.test.js

@@ -0,0 +1,107 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import {
+  formatSummary,
+  parseIssueLine,
+  parseIssues,
+  summarizeIssues,
+} from '../src/issue-triage.js';
+
+describe('issue triage example', () => {
+  it('parses a basic issue line', () => {
+    assert.deepEqual(
+      parseIssueLine('- [P1] auth: Login fails @web #bug #customer'),
+      {
+        priority: 'P1',
+        area: 'auth',
+        title: 'Login fails',
+        owner: 'web',
+        tags: ['bug', 'customer'],
+      },
+    );
+  });
+
+  it('parses multiple issue lines while ignoring blanks and comments', () => {
+    assert.deepEqual(
+      parseIssues(`
+- [P1] auth: Login fails @web #bug #customer
+
+// keep this scenario in the sample input but out of the parsed issues
+- [P2] billing: Invoice total is wrong @api #bug
+`),
+      [
+        {
+          priority: 'P1',
+          area: 'auth',
+          title: 'Login fails',
+          owner: 'web',
+          tags: ['bug', 'customer'],
+        },
+        {
+          priority: 'P2',
+          area: 'billing',
+          title: 'Invoice total is wrong',
+          owner: 'api',
+          tags: ['bug'],
+        },
+      ],
+    );
+  });
+
+  it('summarizes counts by priority, area, owner, and tag', () => {
+    const summary = summarizeIssues([
+      parseIssueLine('- [P1] auth: Login fails @web #bug #customer'),
+      parseIssueLine('- [P1] auth: Session expires early @web #bug'),
+      parseIssueLine('- [P2] billing: Invoice total is wrong @api #bug'),
+    ]);
+
+    assert.deepEqual(summary, {
+      total: 3,
+      byPriority: {
+        P1: 2,
+        P2: 1,
+      },
+      byArea: {
+        auth: 2,
+        billing: 1,
+      },
+      byOwner: {
+        web: 2,
+        api: 1,
+      },
+      byTag: {
+        bug: 3,
+        customer: 1,
+      },
+    });
+  });
+
+  it('formats a minimal markdown summary', () => {
+    const summary = summarizeIssues([
+      parseIssueLine('- [P1] auth: Login fails @web #bug #customer'),
+    ]);
+
+    assert.equal(
+      formatSummary(summary),
+      [
+        '# Issue Summary',
+        '',
+        'Total: 1',
+        '',
+        '## Priorities',
+        '- P1: 1',
+        '',
+        '## Areas',
+        '- auth: 1',
+        '',
+        '## Owners',
+        '- web: 1',
+        '',
+        '## Tags',
+        '- bug: 1',
+        '- customer: 1',
+      ].join('\n'),
+    );
+  });
+});

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@navels/neal",
+  "version": "0.1.0",
+  "description": "A source-first multi-agent CLI for planning, executing, reviewing, and resuming scoped code changes.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Lee Nave",
+  "type": "module",
+  "packageManager": "pnpm@11.12.0",
+  "homepage": "https://github.com/navels/neal#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/navels/neal.git"
+  },
+  "bugs": {
+    "url": "https://github.com/navels/neal/issues"
+  },
+  "keywords": [
+    "agent",
+    "cli",
+    "codex",
+    "claude",
+    "code-review",
+    "multi-agent",
+    "planning",
+    "refactoring"
+  ],
+  "bin": {
+    "neal": "dist/neal/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SECURITY.md",
+    "LICENSE",
+    "config.yml",
+    "docs",
+    "examples"
+  ],
+  "engines": {
+    "node": ">=22.13",
+    "pnpm": ">=11"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && chmod +x dist/neal/index.js",
+    "pack:local": "pnpm build && pnpm pack",
+    "verify:package": "pnpm build && node scripts/verify-package.mjs",
+    "validate:release": "node scripts/validate-release.mjs",
+    "dev:link": "pnpm build && npm link",
+    "start": "tsx src/neal/index.ts",
+    "test": "NEAL_NOTIFY_BIN= node --import tsx --test test/*.test.ts",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "2.0.49",
+    "@anthropic-ai/claude-agent-sdk": "0.3.163",
+    "@openai/codex-sdk": "0.137.0",
+    "ai": "6.0.202",
+    "dotenv": "^17.4.2",
+    "yaml": "^2.8.3",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3"
+  }
+}