@cluesmith/codev 2.1.5 → 3.0.0-rc.1

package/dist/lib/team-github.d.ts

@@ -0,0 +1,58 @@
+/**
+ * GitHub data enrichment for team members.
+ *
+ * Fetches assigned issues, open PRs, and recent activity for each
+ * team member using a single batched GraphQL query via `gh api graphql`.
+ *
+ * Spec 587: Team Tab in Tower Right Panel.
+ */
+import type { TeamMember } from './team.js';
+export interface TeamMemberGitHubData {
+    assignedIssues: {
+        number: number;
+        title: string;
+        url: string;
+    }[];
+    openPRs: {
+        number: number;
+        title: string;
+        url: string;
+    }[];
+    recentActivity: {
+        mergedPRs: {
+            number: number;
+            title: string;
+            mergedAt: string;
+        }[];
+        closedIssues: {
+            number: number;
+            title: string;
+            closedAt: string;
+        }[];
+    };
+}
+export declare function getRepoInfo(cwd?: string): Promise<{
+    owner: string;
+    name: string;
+} | null>;
+/**
+ * Build a batched GraphQL query that fetches assigned issues, authored PRs,
+ * and recent activity for all team members in one request.
+ *
+ * Owner/name are interpolated directly into search strings because
+ * GraphQL variables are not substituted inside string literals.
+ */
+export declare function buildTeamGraphQLQuery(members: TeamMember[], owner: string, name: string): string;
+/**
+ * Parse the GraphQL response into a map of github handle → TeamMemberGitHubData.
+ */
+export declare function parseTeamGraphQLResponse(data: Record<string, unknown>, members: TeamMember[]): Map<string, TeamMemberGitHubData>;
+/**
+ * Fetch GitHub data for all team members in a single batched GraphQL request.
+ * Returns null on failure (graceful degradation).
+ */
+export declare function fetchTeamGitHubData(members: TeamMember[], cwd?: string): Promise<{
+    data: Map<string, TeamMemberGitHubData>;
+    error?: string;
+}>;
+//# sourceMappingURL=team-github.d.ts.map

package/dist/lib/team-github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-github.d.ts","sourceRoot":"","sources":["../../src/lib/team-github.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQ5C,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1D,cAAc,EAAE;QACd,SAAS,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACjE,YAAY,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACrE,CAAC;CACH;AAMD,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAU/F;AAqBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BhG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,UAAU,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAuBnC;AAMD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,UAAU,EAAE,EACrB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BtE"}

package/dist/lib/team-github.js

@@ -0,0 +1,134 @@
+/**
+ * GitHub data enrichment for team members.
+ *
+ * Fetches assigned issues, open PRs, and recent activity for each
+ * team member using a single batched GraphQL query via `gh api graphql`.
+ *
+ * Spec 587: Team Tab in Tower Right Panel.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { isValidGitHubHandle } from './team.js';
+const execFileAsync = promisify(execFile);
+// =============================================================================
+// Repo Detection
+// =============================================================================
+export async function getRepoInfo(cwd) {
+    try {
+        const { stdout } = await execFileAsync('gh', [
+            'repo', 'view', '--json', 'owner,name',
+        ], { cwd });
+        const repo = JSON.parse(stdout);
+        return { owner: repo.owner.login, name: repo.name };
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// GraphQL Query Building
+// =============================================================================
+function sevenDaysAgo() {
+    const d = new Date();
+    d.setDate(d.getDate() - 7);
+    return d.toISOString().split('T')[0]; // YYYY-MM-DD
+}
+/**
+ * Sanitize a GitHub handle for use as a GraphQL alias.
+ * Replaces hyphens with underscores and prefixes with `u_` to avoid
+ * aliases starting with a digit (invalid in GraphQL).
+ */
+function toAlias(handle) {
+    return `u_${handle.replace(/-/g, '_')}`;
+}
+/**
+ * Build a batched GraphQL query that fetches assigned issues, authored PRs,
+ * and recent activity for all team members in one request.
+ *
+ * Owner/name are interpolated directly into search strings because
+ * GraphQL variables are not substituted inside string literals.
+ */
+export function buildTeamGraphQLQuery(members, owner, name) {
+    const since = sevenDaysAgo();
+    const repo = `${owner}/${name}`;
+    const fragments = members
+        .filter(m => isValidGitHubHandle(m.github))
+        .map((m) => {
+        const alias = toAlias(m.github);
+        return `
+    ${alias}_assigned: search(query: "repo:${repo} assignee:${m.github} is:issue is:open", type: ISSUE, first: 20) {
+      nodes { ... on Issue { number title url } }
+    }
+    ${alias}_prs: search(query: "repo:${repo} author:${m.github} is:pr is:open", type: ISSUE, first: 20) {
+      nodes { ... on PullRequest { number title url } }
+    }
+    ${alias}_merged: search(query: "repo:${repo} author:${m.github} is:pr is:merged merged:>=${since}", type: ISSUE, first: 20) {
+      nodes { ... on PullRequest { number title mergedAt } }
+    }
+    ${alias}_closed: search(query: "repo:${repo} assignee:${m.github} is:issue is:closed closed:>=${since}", type: ISSUE, first: 20) {
+      nodes { ... on Issue { number title closedAt } }
+    }`;
+    })
+        .join('\n');
+    return `{
+  ${fragments}
+}`;
+}
+/**
+ * Parse the GraphQL response into a map of github handle → TeamMemberGitHubData.
+ */
+export function parseTeamGraphQLResponse(data, members) {
+    const result = new Map();
+    for (const member of members) {
+        if (!isValidGitHubHandle(member.github))
+            continue;
+        const alias = toAlias(member.github);
+        const assigned = data[`${alias}_assigned`];
+        const prs = data[`${alias}_prs`];
+        const merged = data[`${alias}_merged`];
+        const closed = data[`${alias}_closed`];
+        result.set(member.github, {
+            assignedIssues: (assigned?.nodes ?? []).map(n => ({ number: n.number, title: n.title, url: n.url })),
+            openPRs: (prs?.nodes ?? []).map(n => ({ number: n.number, title: n.title, url: n.url })),
+            recentActivity: {
+                mergedPRs: (merged?.nodes ?? []).map(n => ({ number: n.number, title: n.title, mergedAt: n.mergedAt })),
+                closedIssues: (closed?.nodes ?? []).map(n => ({ number: n.number, title: n.title, closedAt: n.closedAt })),
+            },
+        });
+    }
+    return result;
+}
+// =============================================================================
+// Main Fetch Function
+// =============================================================================
+/**
+ * Fetch GitHub data for all team members in a single batched GraphQL request.
+ * Returns null on failure (graceful degradation).
+ */
+export async function fetchTeamGitHubData(members, cwd) {
+    const validMembers = members.filter(m => isValidGitHubHandle(m.github));
+    if (validMembers.length === 0) {
+        return { data: new Map() };
+    }
+    const repo = await getRepoInfo(cwd);
+    if (!repo) {
+        return { data: new Map(), error: 'Could not determine repository (is gh CLI authenticated?)' };
+    }
+    const query = buildTeamGraphQLQuery(validMembers, repo.owner, repo.name);
+    try {
+        const { stdout } = await execFileAsync('gh', [
+            'api', 'graphql',
+            '-f', `query=${query}`,
+        ], { cwd });
+        const response = JSON.parse(stdout);
+        if (!response.data) {
+            return { data: new Map(), error: 'GitHub GraphQL returned no data' };
+        }
+        return { data: parseTeamGraphQLResponse(response.data, validMembers) };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { data: new Map(), error: `GitHub API request failed: ${message}` };
+    }
+}
+//# sourceMappingURL=team-github.js.map

package/dist/lib/team-github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-github.js","sourceRoot":"","sources":["../../src/lib/team-github.ts"],"names":[],"mappings":"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"}

package/dist/lib/team.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Team directory infrastructure for Codev.
+ *
+ * Reads team member files from codev/team/people/*.md (YAML frontmatter)
+ * and messages from codev/team/messages.md (append-only log).
+ *
+ * Spec 587: Team Tab in Tower Right Panel.
+ */
+export interface TeamMember {
+    name: string;
+    github: string;
+    role: string;
+    filePath: string;
+}
+export interface TeamMessage {
+    author: string;
+    timestamp: string;
+    body: string;
+    channel: string;
+}
+export interface MessageChannel {
+    name: string;
+    getMessages(): Promise<TeamMessage[]>;
+}
+export interface LoadResult<T> {
+    items: T[];
+    warnings: string[];
+}
+/**
+ * Parse YAML frontmatter from a markdown file content string.
+ * Splits on `---` delimiters and parses the middle section with js-yaml.
+ */
+export declare function parseFrontmatter(content: string): Record<string, unknown> | null;
+export declare function isValidGitHubHandle(handle: string): boolean;
+/**
+ * Load team members from codev/team/people/*.md files.
+ * Returns parsed members and any warnings encountered.
+ */
+export declare function loadTeamMembers(teamDir: string): Promise<LoadResult<TeamMember>>;
+/**
+ * Parse a single message block (text between --- separators).
+ * Expected format:
+ *   **author** | timestamp
+ *   body text
+ */
+export declare function parseMessageBlock(block: string): TeamMessage | null;
+/**
+ * Load messages from an append-only messages.md file.
+ * Each message is separated by `---`.
+ */
+export declare function loadMessages(messagesPath: string): Promise<LoadResult<TeamMessage>>;
+/**
+ * Check if a valid team exists (codev/team/ with 2+ valid member files in people/).
+ * Reads and validates frontmatter to ensure members have required fields.
+ */
+export declare function hasTeam(teamDir: string): Promise<boolean>;
+/**
+ * Append a message to the messages.md file.
+ * Creates the file with header if it doesn't exist.
+ */
+export declare function appendMessage(messagesPath: string, author: string, text: string): Promise<void>;
+export declare class FileMessageChannel implements MessageChannel {
+    name: string;
+    private messagesPath;
+    constructor(messagesPath: string);
+    getMessages(): Promise<TeamMessage[]>;
+}
+//# sourceMappingURL=team.d.ts.map

package/dist/lib/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../src/lib/team.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiBhF;AAWD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CA0DtF;AAQD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAcnE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CA4BzF;AAMD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/D;AAWD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkBf;AAMD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,IAAI,SAAU;IACd,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM;IAI1B,WAAW,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAI5C"}

package/dist/lib/team.js

@@ -0,0 +1,215 @@
+/**
+ * Team directory infrastructure for Codev.
+ *
+ * Reads team member files from codev/team/people/*.md (YAML frontmatter)
+ * and messages from codev/team/messages.md (append-only log).
+ *
+ * Spec 587: Team Tab in Tower Right Panel.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+// =============================================================================
+// Frontmatter Parsing
+// =============================================================================
+/**
+ * Parse YAML frontmatter from a markdown file content string.
+ * Splits on `---` delimiters and parses the middle section with js-yaml.
+ */
+export function parseFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---'))
+        return null;
+    const secondDash = trimmed.indexOf('---', 3);
+    if (secondDash === -1)
+        return null;
+    const frontmatterStr = trimmed.slice(3, secondDash).trim();
+    if (!frontmatterStr)
+        return null;
+    try {
+        const parsed = yaml.load(frontmatterStr);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Team Members
+// =============================================================================
+// GitHub's documented rules say no trailing hyphens or consecutive hyphens,
+// but real accounts like "timeleft--" exist. Match what GitHub actually allows:
+// starts with alphanumeric, then any mix of alphanumeric and hyphens.
+const GITHUB_HANDLE_RE = /^[a-zA-Z0-9][a-zA-Z0-9-]*$/;
+export function isValidGitHubHandle(handle) {
+    return GITHUB_HANDLE_RE.test(handle) && handle.length <= 39;
+}
+/**
+ * Load team members from codev/team/people/*.md files.
+ * Returns parsed members and any warnings encountered.
+ */
+export async function loadTeamMembers(teamDir) {
+    const peopleDir = path.join(teamDir, 'people');
+    const warnings = [];
+    const members = [];
+    const seenHandles = new Set();
+    let files;
+    try {
+        const entries = await fs.readdir(peopleDir);
+        files = entries.filter(f => f.endsWith('.md')).sort();
+    }
+    catch {
+        return { items: [], warnings: [`people/ directory not found: ${peopleDir}`] };
+    }
+    for (const file of files) {
+        const filePath = path.join(peopleDir, file);
+        let content;
+        try {
+            content = await fs.readFile(filePath, 'utf-8');
+        }
+        catch {
+            warnings.push(`Could not read ${file}`);
+            continue;
+        }
+        const frontmatter = parseFrontmatter(content);
+        if (!frontmatter) {
+            warnings.push(`Malformed YAML frontmatter in ${file}`);
+            continue;
+        }
+        const name = typeof frontmatter.name === 'string' ? frontmatter.name.trim() : '';
+        const github = typeof frontmatter.github === 'string' ? frontmatter.github.trim() : '';
+        const role = typeof frontmatter.role === 'string' ? frontmatter.role.trim() : 'member';
+        if (!name) {
+            warnings.push(`Missing 'name' field in ${file}`);
+            continue;
+        }
+        if (!github) {
+            warnings.push(`Missing 'github' field in ${file}`);
+            continue;
+        }
+        if (!isValidGitHubHandle(github)) {
+            warnings.push(`Invalid GitHub handle '${github}' in ${file} (skipped)`);
+            continue;
+        }
+        const handleLower = github.toLowerCase();
+        if (seenHandles.has(handleLower)) {
+            warnings.push(`Duplicate GitHub handle '${github}' in ${file} (skipped)`);
+            continue;
+        }
+        seenHandles.add(handleLower);
+        members.push({ name, github, role, filePath });
+    }
+    return { items: members, warnings };
+}
+// =============================================================================
+// Messages
+// =============================================================================
+const MESSAGE_HEADER_RE = /^\*\*([^*]+)\*\*\s*\|\s*(.+)$/;
+/**
+ * Parse a single message block (text between --- separators).
+ * Expected format:
+ *   **author** | timestamp
+ *   body text
+ */
+export function parseMessageBlock(block) {
+    const lines = block.trim().split('\n');
+    if (lines.length === 0)
+        return null;
+    const headerMatch = lines[0].match(MESSAGE_HEADER_RE);
+    if (!headerMatch)
+        return null;
+    const author = headerMatch[1].trim();
+    const timestamp = headerMatch[2].trim();
+    const body = lines.slice(1).join('\n').trim();
+    if (!author || !timestamp)
+        return null;
+    return { author, timestamp, body, channel: 'file' };
+}
+/**
+ * Load messages from an append-only messages.md file.
+ * Each message is separated by `---`.
+ */
+export async function loadMessages(messagesPath) {
+    const warnings = [];
+    let content;
+    try {
+        content = await fs.readFile(messagesPath, 'utf-8');
+    }
+    catch {
+        return { items: [], warnings: [] };
+    }
+    const blocks = content.split(/^---$/m);
+    const messages = [];
+    for (const block of blocks) {
+        const trimmed = block.trim();
+        if (!trimmed)
+            continue;
+        // Skip the header line (# Team Messages) and comments
+        if (trimmed.startsWith('#') || trimmed.startsWith('<!--'))
+            continue;
+        const message = parseMessageBlock(trimmed);
+        if (message) {
+            messages.push(message);
+        }
+        else if (trimmed.length > 0 && !trimmed.startsWith('#') && !trimmed.startsWith('<!--')) {
+            warnings.push(`Malformed message block skipped: ${trimmed.slice(0, 50)}...`);
+        }
+    }
+    return { items: messages, warnings };
+}
+// =============================================================================
+// Team Detection
+// =============================================================================
+/**
+ * Check if a valid team exists (codev/team/ with 2+ valid member files in people/).
+ * Reads and validates frontmatter to ensure members have required fields.
+ */
+export async function hasTeam(teamDir) {
+    const result = await loadTeamMembers(teamDir);
+    return result.items.length >= 2;
+}
+// =============================================================================
+// Message Appending
+// =============================================================================
+const MESSAGES_HEADER = `# Team Messages
+
+<!-- Append new messages below. Do not edit or delete existing entries. -->
+`;
+/**
+ * Append a message to the messages.md file.
+ * Creates the file with header if it doesn't exist.
+ */
+export async function appendMessage(messagesPath, author, text) {
+    const timestamp = new Date().toISOString().replace('T', ' ').replace(/\.\d+Z$/, ' UTC');
+    let exists = false;
+    try {
+        await fs.access(messagesPath);
+        exists = true;
+    }
+    catch {
+        // File doesn't exist — will create it
+    }
+    if (!exists) {
+        await fs.mkdir(path.dirname(messagesPath), { recursive: true });
+        await fs.writeFile(messagesPath, MESSAGES_HEADER, 'utf-8');
+    }
+    const entry = `\n---\n**${author}** | ${timestamp}\n${text}\n`;
+    await fs.appendFile(messagesPath, entry, 'utf-8');
+}
+// =============================================================================
+// FileMessageChannel
+// =============================================================================
+export class FileMessageChannel {
+    name = 'file';
+    messagesPath;
+    constructor(messagesPath) {
+        this.messagesPath = messagesPath;
+    }
+    async getMessages() {
+        const result = await loadMessages(this.messagesPath);
+        return result.items;
+    }
+}
+//# sourceMappingURL=team.js.map

package/dist/lib/team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.js","sourceRoot":"","sources":["../../src/lib/team.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev",
-  "version": "2.1.5",
+  "version": "3.0.0-rc.1",
   "description": "Codev CLI - AI-assisted software development framework",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
     "porch": "./bin/porch.js",
     "af": "./bin/af.js",
     "consult": "./bin/consult.js",
+    "team": "./bin/team.js",
     "generate-image": "./bin/generate-image.js"
   },
   "files": [