@zibby/skills 0.1.95 → 0.2.0

package/dist/socialCard.d.ts

@@ -1,89 +1,35 @@
-export namespace socialCardSkill {
-    let id: string;
-    let serverName: string;
-    let allowedTools: string[];
-    let description: string;
-    let promptFragment: string;
-    function resolve({ sessionPath, nodeName }?: {}): {
-        command: any;
-        args: any[];
-        env: {};
-        description: string;
-        type?: undefined;
-        alwaysLoad?: undefined;
-    } | {
-        type: string;
-        command: string;
-        args: any[];
-        env: {
-            ZIBBY_NODE_SESSION_PATH: any;
-            ZIBBY_SESSION_PATH: any;
-        };
-        description: string;
-        alwaysLoad: boolean;
-    };
-    function handleToolCall(name: any, args: any): Promise<string>;
-    let tools: {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                headline: {
-                    type: string;
-                    description: string;
-                };
-                eyebrow: {
-                    type: string;
-                    description: string;
-                };
-                subhead: {
-                    type: string;
-                    description: string;
-                };
-                stat: {
-                    type: string;
-                    description: string;
-                };
-                footer: {
-                    type: string;
-                    description: string;
-                };
-                diagram: {
-                    type: string;
-                    items: {
-                        type: string;
-                    };
-                    description: string;
-                };
-                theme: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                accent: {
-                    type: string;
-                    description: string;
-                };
-                width: {
-                    type: string;
-                    description: string;
-                };
-                height: {
-                    type: string;
-                    description: string;
-                };
-                filename: {
-                    type: string;
-                    description: string;
-                };
-                output: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-            };
-            required: string[];
-        };
-    }[];
-}
+/**
+ * socialCard.js — local, server-side "concept card" renderer (tier ①: API-only,
+ * fully local — nothing leaves the box; no browser, no external service).
+ *
+ * WHAT IT IS
+ * ──────────
+ * A hand-written single-tool skill (same shape as chartRender.js / kvMemory.js:
+ * `serverName`, `allowedTools`, `tools[]`, `handleToolCall`, and a `resolve()`
+ * that spawns the GENERIC bin/mcp-skill.mjs). One tool — `social_card_render` —
+ * takes STRUCTURED, agent-supplied fields (headline, eyebrow, subhead, stat,
+ * footer, diagram, theme, accent) and renders a branded LinkedIn "concept card"
+ * PNG in the Darren-Bounds style (bold headline + small uppercase eyebrow +
+ * optional stat/footer + optional A—✓—B diagram).
+ *
+ * RENDER PIPELINE
+ * ───────────────
+ * A HAND-AUTHORED SVG string (NOT ECharts) → rasterized to PNG via
+ * @resvg/resvg-js, EXACTLY like chartRender's renderPng() helper. No echarts
+ * dependency — the composition is laid out here in plain SVG.
+ *
+ * FONTS — the agent container may ship NO fonts, and resvg renders EMPTY text
+ * without one. We reuse the bundled Noto Sans Regular + Bold faces (the same
+ * assets/fonts chartRender bundles) and set 'Noto Sans' as the default family.
+ * `loadSystemFonts:true` stays on so a host WITH fonts can still satisfy exotic
+ * glyphs (e.g. a ★ in a caller's stat) the bundled faces may lack. The one
+ * glyph WE draw (the diagram checkmark) is a vector <path>, never a font glyph,
+ * so it renders regardless of available fonts.
+ *
+ * OUTPUT FILES — same convention as chartRender: the PNG lands under the run's
+ * session output dir (ZIBBY_NODE_SESSION_PATH / ZIBBY_SESSION_PATH) so the CLI
+ * session-uploader auto-attaches it; local dev falls back to
+ * <cwd>/.zibby/output/social-cards. The returned `path` can be passed to a
+ * LinkedIn post's `imagePath`.
+ */
+export declare const socialCardSkill: any;

package/dist/test-runner.d.ts

@@ -1,220 +1 @@
-export namespace testRunnerSkill {
-    let id: string;
-    let description: string;
-    let envKeys: any[];
-    let promptFragment: string;
-    function resolve(): any;
-    function handleToolCall(name: any, args: any, context: any): Promise<any>;
-    let tools: ({
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                ticket: {
-                    type: string;
-                    description: string;
-                };
-                description: {
-                    type: string;
-                    description: string;
-                };
-                input: {
-                    type: string;
-                    description: string;
-                };
-                repo: {
-                    type: string;
-                    description: string;
-                };
-                agent: {
-                    type: string;
-                    description: string;
-                };
-                output: {
-                    type: string;
-                    description: string;
-                };
-                spec?: undefined;
-                ticketKey?: undefined;
-                headless?: undefined;
-                workflow?: undefined;
-                runId?: undefined;
-                type?: undefined;
-                node?: undefined;
-                query?: undefined;
-                tail?: undefined;
-                directory?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                spec: {
-                    type: string;
-                    description: string;
-                };
-                ticketKey: {
-                    type: string;
-                    description: string;
-                };
-                agent: {
-                    type: string;
-                    description: string;
-                };
-                headless: {
-                    type: string;
-                    description: string;
-                };
-                workflow: {
-                    type: string;
-                    description: string;
-                };
-                ticket?: undefined;
-                description?: undefined;
-                input?: undefined;
-                repo?: undefined;
-                output?: undefined;
-                runId?: undefined;
-                type?: undefined;
-                node?: undefined;
-                query?: undefined;
-                tail?: undefined;
-                directory?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                runId: {
-                    type: string;
-                    description: string;
-                };
-                ticket?: undefined;
-                description?: undefined;
-                input?: undefined;
-                repo?: undefined;
-                agent?: undefined;
-                output?: undefined;
-                spec?: undefined;
-                ticketKey?: undefined;
-                headless?: undefined;
-                workflow?: undefined;
-                type?: undefined;
-                node?: undefined;
-                query?: undefined;
-                tail?: undefined;
-                directory?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                runId: {
-                    type: string;
-                    description: string;
-                };
-                type: {
-                    type: string;
-                    enum: string[];
-                    description: string;
-                };
-                node: {
-                    type: string;
-                    description: string;
-                };
-                query: {
-                    type: string;
-                    description: string;
-                };
-                tail: {
-                    type: string;
-                    description: string;
-                };
-                ticket?: undefined;
-                description?: undefined;
-                input?: undefined;
-                repo?: undefined;
-                agent?: undefined;
-                output?: undefined;
-                spec?: undefined;
-                ticketKey?: undefined;
-                headless?: undefined;
-                workflow?: undefined;
-                directory?: undefined;
-            };
-            required: string[];
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                runId: {
-                    type: string;
-                    description: string;
-                };
-                tail: {
-                    type: string;
-                    description: string;
-                };
-                ticket?: undefined;
-                description?: undefined;
-                input?: undefined;
-                repo?: undefined;
-                agent?: undefined;
-                output?: undefined;
-                spec?: undefined;
-                ticketKey?: undefined;
-                headless?: undefined;
-                workflow?: undefined;
-                type?: undefined;
-                node?: undefined;
-                query?: undefined;
-                directory?: undefined;
-            };
-            required?: undefined;
-        };
-    } | {
-        name: string;
-        description: string;
-        input_schema: {
-            type: string;
-            properties: {
-                directory: {
-                    type: string;
-                    description: string;
-                };
-                ticket?: undefined;
-                description?: undefined;
-                input?: undefined;
-                repo?: undefined;
-                agent?: undefined;
-                output?: undefined;
-                spec?: undefined;
-                ticketKey?: undefined;
-                headless?: undefined;
-                workflow?: undefined;
-                runId?: undefined;
-                type?: undefined;
-                node?: undefined;
-                query?: undefined;
-                tail?: undefined;
-            };
-            required?: undefined;
-        };
-    })[];
-}
+export declare const testRunnerSkill: any;

package/dist/trackers/github-adapter.d.ts

@@ -1,96 +1,41 @@
-export namespace githubAdapter {
-    export let id: string;
-    export { toStateCategory };
-    export { toNeutral };
-    export { IN_PROGRESS_LABEL };
-    export { BLOCKED_LABEL };
-    /**
-     * listCandidates — list a repo's issues by state/labels/since cursor.
-     * Needs {owner, repo} via opts.ctx or env. `opts.query` is ignored (GitHub
-     * issue search is a separate endpoint; the contract's listCandidates is the
-     * repo-scoped poll).
-     * @param {import('./types.js').ListCandidatesOptions & {ctx?: object}} [opts]
-     * @returns {Promise<import('./types.js').NeutralTicket[]>}
-     */
-    export function listCandidates(opts?: import("./types.js").ListCandidatesOptions & {
-        ctx?: object;
-    }): Promise<import("./types.js").NeutralTicket[]>;
-    /** getTicket — one issue by number (key may be `owner/repo#N` or just `N`). */
-    export function getTicket(key: any, ctx?: {}): Promise<{
-        id: string;
-        key: string;
-        title: any;
-        body: any;
-        state: any;
-        stateCategory: "unknown" | "todo" | "in_progress" | "done" | "blocked";
-        assignee: any;
-        url: any;
-        _raw: any;
-    }>;
-    /** getComments — chronological; we reverse to newest-first for contract parity. */
-    export function getComments(key: any, ctx?: {}): Promise<any>;
-    /** addComment — markdown body. */
-    export function addComment(key: any, body: any, ctx?: {}): Promise<{
-        ok: boolean;
-        id: string;
-    }>;
-    /**
-     * transition — map a neutral target NAME onto GitHub's open/close + labels
-     * convention (see the file header). Returns ok:false for names GitHub can't
-     * represent — that's a real seam, not a swallowed error.
-     */
-    export function transition(key: any, targetStateName: any, ctx?: {}): Promise<{
-        ok: boolean;
-        stateAfter: any;
-        stateCategoryAfter: string;
-        _raw: any;
-        via?: undefined;
-        error?: undefined;
-    } | {
-        ok: boolean;
-        stateAfter: string;
-        stateCategoryAfter: string;
-        via: string;
-        _raw: any;
-        error?: undefined;
-    } | {
-        ok: boolean;
-        error: string;
-        stateAfter?: undefined;
-        stateCategoryAfter?: undefined;
-        _raw?: undefined;
-        via?: undefined;
-    }>;
-    /**
-     * linkPullRequest — post a comment with the PR link. GitHub's native issue↔PR
-     * association is driven by closing keywords in the PR body, not an issue API
-     * write, so a comment is the portable, always-works path.
-     */
-    export function linkPullRequest(key: any, prUrl: any, title: any, ctx?: {}): Promise<{
-        ok: boolean;
-        via: string;
-    }>;
-}
-export default githubAdapter;
 /**
- * Map a GitHub issue's open|closed state + its labels onto a neutral bucket.
- * @param {string} state           'open' | 'closed'
- * @param {string[]} [labels]      label names on the issue
- * @returns {'todo'|'in_progress'|'done'|'blocked'|'unknown'}
+ * GitHub Issues tracker adapter — projects GitHub onto the neutral
+ * TrackerAdapter contract.
+ * ============================================================================
+ *
+ * Thin wrapper over github.js. GitHub Issues are the awkward provider for a
+ * tracker abstraction, because GitHub has NO workflow/transition model: an
+ * issue is just open|closed. Everything richer (todo vs in-progress, blocked)
+ * is a labelling CONVENTION, not a native state. This adapter makes that
+ * convention explicit and keeps it documented in one place.
+ *
+ * SCOPING: GitHub issues live in a repo, so every method needs {owner, repo}.
+ * That comes from `ctx` (per-call) or env GITHUB_OWNER / GITHUB_REPO. There is
+ * no global "list all my issues" call here on purpose — it would not map.
+ *
+ * STATE MODEL (the real seam — read this):
+ *   - closed                    → 'done'
+ *   - open + a blocked label     → 'blocked'   (label matches BLOCKED_NAME_RE)
+ *   - open + an in-progress label→ 'in_progress' (label matches IN_PROGRESS_RE,
+ *                                  e.g. "in progress", "in-progress", "wip",
+ *                                  "doing", "started")
+ *   - open + (none of the above) → 'todo'
+ *   The labels are a CONVENTION: GitHub has no concept of them being "states".
+ *   A repo that doesn't use them simply shows every open issue as 'todo'.
+ *
+ * transition (NO native equivalent) maps the target name onto this convention:
+ *   - a done/closed-ish name  → close the issue (state_reason 'completed')
+ *   - a todo/open-ish name    → reopen + clear progress/blocked labels
+ *   - 'in progress'-ish name  → ensure open + ADD the in-progress label
+ *   - 'blocked'-ish name      → ensure open + ADD the blocked label
+ *   - anything else           → ok:false (unrepresentable on GitHub) — this is a
+ *                               genuine contract seam, surfaced honestly.
+ *
+ * linkPullRequest: a comment carrying the PR URL (GitHub's native issue↔PR link
+ * requires a closing keyword IN the PR body / a cross-ref event, not an issue
+ * API write, so the portable, always-works path is a comment).
+ *
+ * Auth/config is inherited from github.js (resolveIntegrationToken('github')).
  */
-declare function toStateCategory(state: string, labels?: string[]): "todo" | "in_progress" | "done" | "blocked" | "unknown";
-/** Build a NeutralTicket from the github.js issue tool projection. */
-declare function toNeutral(issue: any, ctx?: {}): {
-    id: string;
-    key: string;
-    title: any;
-    body: any;
-    state: any;
-    stateCategory: "unknown" | "todo" | "in_progress" | "done" | "blocked";
-    assignee: any;
-    url: any;
-    _raw: any;
-};
-/** Conventional label names this adapter writes for the two open sub-states. */
-declare const IN_PROGRESS_LABEL: "in progress";
-declare const BLOCKED_LABEL: "blocked";
+export declare const githubAdapter: any;
+export default githubAdapter;

package/dist/trackers/index.d.ts

@@ -1,3 +1,27 @@
+/**
+ * Neutral tracker adapter registry.
+ * ============================================================================
+ *
+ * The "neutrality" entry point: pick a tracker by provider id (or by the
+ * TRACKER_PROVIDER env var) and drive ANY of Jira / Linear / GitHub / Plane
+ * through the same 6-method TrackerAdapter contract. A pipeline that talks to
+ * `getAdapter()` is provider-agnostic — switching trackers is a config change,
+ * not a code change.
+ *
+ * See ./types.js for the NeutralTicket / NeutralComment / TrackerAdapter docs.
+ */
+export { jiraAdapter } from './jira-adapter.js';
+export { linearAdapter } from './linear-adapter.js';
+export { githubAdapter } from './github-adapter.js';
+export { planeAdapter } from './plane-adapter.js';
+export { TRACKER_STATE_CATEGORIES } from './types.js';
+/**
+ * Provider id → adapter. Keys are the canonical provider ids; each value is a
+ * {@link import('./types.js').TrackerAdapter}.
+ */
+export declare const TRACKER_ADAPTERS: any;
+/** Default provider when none is specified and TRACKER_PROVIDER is unset. */
+export declare const DEFAULT_TRACKER_PROVIDER = "jira";
 /**
  * Resolve a tracker adapter.
  *
@@ -7,21 +31,4 @@
  * @returns {import('./types.js').TrackerAdapter}
  * @throws {Error} if the resolved provider is not registered.
  */
-export function getAdapter(provider?: string): import("./types.js").TrackerAdapter;
-export { jiraAdapter } from "./jira-adapter.js";
-export { linearAdapter } from "./linear-adapter.js";
-export { githubAdapter } from "./github-adapter.js";
-export { planeAdapter } from "./plane-adapter.js";
-export { TRACKER_STATE_CATEGORIES } from "./types.js";
-export namespace TRACKER_ADAPTERS {
-    export { jiraAdapter as jira };
-    export { linearAdapter as linear };
-    export { githubAdapter as github };
-    export { planeAdapter as plane };
-}
-/** Default provider when none is specified and TRACKER_PROVIDER is unset. */
-export const DEFAULT_TRACKER_PROVIDER: "jira";
-import { jiraAdapter } from './jira-adapter.js';
-import { linearAdapter } from './linear-adapter.js';
-import { githubAdapter } from './github-adapter.js';
-import { planeAdapter } from './plane-adapter.js';
+export declare function getAdapter(provider: any): any;

package/dist/trackers/jira-adapter.d.ts

@@ -1,90 +1,22 @@
-export namespace jiraAdapter {
-    export let id: string;
-    export { toStateCategory };
-    export { toNeutral };
-    /**
-     * listCandidates — JQL search. `opts.query` is the JQL; if omitted we build a
-     * bounded default. Returns newest-updated first.
-     * @param {import('./types.js').ListCandidatesOptions} [opts]
-     * @returns {Promise<import('./types.js').NeutralTicket[]>}
-     */
-    export function listCandidates(opts?: import("./types.js").ListCandidatesOptions): Promise<import("./types.js").NeutralTicket[]>;
-    /**
-     * getTicket — one issue by key. Uses jiraFetch (not jira_get_issue) so the
-     * full status object incl. statusCategory is present for bucketing.
-     */
-    export function getTicket(key: any): Promise<{
-        id: string;
-        key: any;
-        title: any;
-        body: any;
-        state: any;
-        stateCategory: "unknown" | "todo" | "in_progress" | "done" | "blocked";
-        assignee: any;
-        url: string;
-        _raw: any;
-    }>;
-    /** getComments — newest first (jira_get_comments already flattens ADF). */
-    export function getComments(key: any): Promise<any>;
-    /** addComment — delegates to jira_add_comment (wraps text in ADF). */
-    export function addComment(key: any, body: any): Promise<{
-        ok: boolean;
-        id: any;
-    }>;
-    /**
-     * transition — reuse jira_transition_issue's fuzzy matching (exact → core →
-     * dice). Returns ok + the resulting raw state name and its bucket.
-     */
-    export function transition(key: any, targetStateName: any): Promise<{
-        ok: boolean;
-        error: any;
-        _raw: any;
-        stateAfter?: undefined;
-        stateCategoryAfter?: undefined;
-    } | {
-        ok: boolean;
-        stateAfter: any;
-        stateCategoryAfter: "unknown" | "todo" | "in_progress" | "done" | "blocked";
-        _raw: any;
-        error?: undefined;
-    }>;
-    /**
-     * linkPullRequest — try Jira's remote-link API; fall back to a comment.
-     * Remote-link needs the granular `write:issue.remote-link:jira` scope; if it
-     * 403s (or anything else), we still record the PR via a comment so the link
-     * is never silently lost.
-     */
-    export function linkPullRequest(key: any, prUrl: any, title: any): Promise<{
-        ok: boolean;
-        via: string;
-        error?: undefined;
-    } | {
-        ok: boolean;
-        via: string;
-        error: string;
-    }>;
-}
-export default jiraAdapter;
 /**
- * Map a Jira status into the neutral 5-bucket category.
- * @param {{name?: string, statusCategory?: {key?: string}}} [status]
- * @returns {'todo'|'in_progress'|'done'|'blocked'|'unknown'}
+ * Jira tracker adapter — projects Jira onto the neutral TrackerAdapter contract.
+ * ============================================================================
+ *
+ * Thin wrapper over jira.js. ~90% of the work is the toNeutral mapping; the
+ * write methods mostly delegate to the JIRA skill's first-class tools
+ * (jira_transition_issue already does the fuzzy status matching we want, so we
+ * do NOT re-implement it). The single gap with no tool is attaching a PR remote
+ * link, which we issue against the exported `jiraFetch` chokepoint directly,
+ * with a comment fallback.
+ *
+ * State mapping: Jira's `statusCategory.key` is a 3-value enum — `new` /
+ * `indeterminate` / `done` (see backend/.../jira-tickets-service.js:70). That
+ * maps cleanly onto three of the five neutral buckets. Jira has no native
+ * "blocked" category, so 'blocked' is only ever derived from a status NAME
+ * match (best-effort), matching how the other adapters surface it.
+ *
+ * Auth/config is inherited from jira.js (resolveIntegrationToken('jira')); this
+ * file adds no new env keys.
  */
-declare function toStateCategory(status?: {
-    name?: string;
-    statusCategory?: {
-        key?: string;
-    };
-}): "todo" | "in_progress" | "done" | "blocked" | "unknown";
-/** Build a NeutralTicket from a full Jira issue REST payload. */
-declare function toNeutral(issue: any, instanceUrl: any): {
-    id: string;
-    key: any;
-    title: any;
-    body: any;
-    state: any;
-    stateCategory: "unknown" | "todo" | "in_progress" | "done" | "blocked";
-    assignee: any;
-    url: string;
-    _raw: any;
-};
+export declare const jiraAdapter: any;
+export default jiraAdapter;