@iflow-mcp/jkheadley-instar 0.26.2

package/dist/publishing/TelegraphService.js

@@ -0,0 +1,410 @@
+/**
+ * Telegraph publishing service for Instar agents.
+ *
+ * Converts markdown to Telegraph Node format and publishes
+ * content via the Telegraph API (telegra.ph). Zero-config,
+ * no rate limits, instant web pages accessible from anywhere.
+ *
+ * IMPORTANT: All Telegraph pages are PUBLIC. There is no authentication
+ * or access control — anyone with the URL can view the content.
+ * Do NOT publish sensitive, private, or confidential information.
+ * For private content, use the Cloudflare Tunnel viewer (when configured).
+ *
+ * Telegraph API docs: https://telegra.ph/api
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ── Service ────────────────────────────────────────────────────────
+const TELEGRAPH_API = 'https://api.telegra.ph';
+export class TelegraphService {
+    config;
+    stateFile;
+    state;
+    constructor(config) {
+        this.config = config;
+        this.stateFile = path.join(config.stateDir, 'publishing.json');
+        this.state = this.loadState();
+    }
+    // ── Account Management ─────────────────────────────────────────
+    /**
+     * Ensure a Telegraph account exists. Creates one if needed.
+     * Returns the access token.
+     */
+    async ensureAccount() {
+        if (this.state.accessToken) {
+            return this.state.accessToken;
+        }
+        const shortName = this.config.shortName || 'instar-agent';
+        const account = await this.createAccount(shortName, this.config.authorName);
+        this.state.accessToken = account.access_token;
+        this.state.shortName = account.short_name;
+        this.state.authorName = account.author_name;
+        this.saveState();
+        return account.access_token;
+    }
+    /**
+     * Create a new Telegraph account.
+     */
+    async createAccount(shortName, authorName) {
+        const params = { short_name: shortName };
+        if (authorName)
+            params.author_name = authorName;
+        if (this.config.authorUrl)
+            params.author_url = this.config.authorUrl;
+        const result = await this.apiCall('createAccount', params);
+        return result;
+    }
+    // ── Publishing ─────────────────────────────────────────────────
+    /**
+     * Publish markdown content as a PUBLIC Telegraph page.
+     *
+     * WARNING: The published page is publicly accessible to anyone with the URL.
+     * Do not publish sensitive or private information.
+     *
+     * Returns the page URL and path.
+     */
+    async publishPage(title, markdown) {
+        const token = await this.ensureAccount();
+        const content = markdownToNodes(markdown);
+        // Validate content size (Telegraph limit: 64KB)
+        const contentJson = JSON.stringify(content);
+        if (contentJson.length > 64000) {
+            throw new Error(`Content too large for Telegraph: ${contentJson.length} bytes (max 64000)`);
+        }
+        const page = await this.apiCall('createPage', {
+            access_token: token,
+            title,
+            content: contentJson,
+            author_name: this.state.authorName || this.config.authorName,
+            author_url: this.config.authorUrl,
+            return_content: 'false',
+        });
+        // Track locally (store token so edits use the correct credential)
+        this.state.pages.push({
+            path: page.path,
+            url: page.url,
+            title,
+            publishedAt: new Date().toISOString(),
+            markdownHash: simpleHash(markdown),
+            accessToken: token,
+        });
+        this.saveState();
+        return page;
+    }
+    /**
+     * Edit an existing Telegraph page.
+     * Uses the original access token stored when the page was created.
+     * Throws a clear error if the page is orphaned (token lost/rotated).
+     */
+    async editPage(pagePath, title, markdown) {
+        const existing = this.state.pages.find(p => p.path === pagePath);
+        // Prefer the per-page token (if stored), fall back to current account token
+        const token = existing?.accessToken || await this.ensureAccount();
+        const content = markdownToNodes(markdown);
+        const contentJson = JSON.stringify(content);
+        if (contentJson.length > 64000) {
+            throw new Error(`Content too large for Telegraph: ${contentJson.length} bytes (max 64000)`);
+        }
+        try {
+            const page = await this.apiCall('editPage', {
+                access_token: token,
+                path: pagePath,
+                title,
+                content: contentJson,
+                author_name: this.state.authorName || this.config.authorName,
+                author_url: this.config.authorUrl,
+                return_content: 'false',
+            });
+            // Update local index
+            if (existing) {
+                existing.title = title;
+                existing.updatedAt = new Date().toISOString();
+                existing.markdownHash = simpleHash(markdown);
+            }
+            this.saveState();
+            return page;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('PAGE_ACCESS_DENIED')) {
+                throw new Error(`Cannot edit page "${pagePath}" — access denied. ` +
+                    `The access token used to create this page ${existing?.accessToken ? 'does not match' : 'was not stored (created before token tracking)'}. ` +
+                    `This page is orphaned and can only be viewed, not edited.`);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Get page view count from Telegraph.
+     */
+    async getPageViews(pagePath) {
+        const result = await this.apiCall('getViews', { path: pagePath });
+        return result.views;
+    }
+    /**
+     * List all locally tracked published pages.
+     */
+    listPages() {
+        return [...this.state.pages];
+    }
+    /**
+     * Get state for inspection/testing.
+     */
+    getState() {
+        return { ...this.state };
+    }
+    // ── Internal ───────────────────────────────────────────────────
+    loadState() {
+        try {
+            if (fs.existsSync(this.stateFile)) {
+                return JSON.parse(fs.readFileSync(this.stateFile, 'utf-8'));
+            }
+        }
+        catch {
+            // Corrupted file — start fresh
+        }
+        return { pages: [] };
+    }
+    saveState() {
+        const dir = path.dirname(this.stateFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(this.stateFile, JSON.stringify(this.state, null, 2));
+    }
+    async apiCall(method, params) {
+        // Filter out undefined values
+        const body = {};
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                body[k] = v;
+        }
+        const response = await fetch(`${TELEGRAPH_API}/${method}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Telegraph API error: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (!data.ok || !data.result) {
+            throw new Error(`Telegraph API error: ${data.error || 'Unknown error'}`);
+        }
+        return data.result;
+    }
+}
+// ── Markdown to Telegraph Node Conversion ──────────────────────────
+/**
+ * Convert markdown text to Telegraph Node[] format.
+ *
+ * Supports: headings (h3/h4), bold, italic, strikethrough, code,
+ * code blocks, links, images, blockquotes, lists (ol/ul),
+ * horizontal rules, and paragraphs.
+ *
+ * Telegraph only supports h3 and h4, so # and ## map to h3,
+ * ### maps to h3, #### and deeper map to h4.
+ */
+export function markdownToNodes(markdown) {
+    const lines = markdown.split('\n');
+    const nodes = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip empty lines
+        if (line.trim() === '') {
+            i++;
+            continue;
+        }
+        // Horizontal rule
+        if (/^(-{3,}|\*{3,}|_{3,})\s*$/.test(line.trim())) {
+            nodes.push({ tag: 'hr' });
+            i++;
+            continue;
+        }
+        // Headings
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            const level = headingMatch[1].length;
+            const tag = level <= 3 ? 'h3' : 'h4';
+            nodes.push({ tag, children: parseInline(headingMatch[2].trim()) });
+            i++;
+            continue;
+        }
+        // Code blocks (fenced)
+        if (line.trim().startsWith('```')) {
+            const codeLines = [];
+            i++; // skip opening fence
+            while (i < lines.length && !lines[i].trim().startsWith('```')) {
+                codeLines.push(lines[i]);
+                i++;
+            }
+            i++; // skip closing fence
+            nodes.push({
+                tag: 'pre',
+                children: [{ tag: 'code', children: [codeLines.join('\n')] }],
+            });
+            continue;
+        }
+        // Blockquote
+        if (line.trimStart().startsWith('> ')) {
+            const quoteLines = [];
+            while (i < lines.length && lines[i].trimStart().startsWith('> ')) {
+                quoteLines.push(lines[i].trimStart().replace(/^>\s?/, ''));
+                i++;
+            }
+            nodes.push({
+                tag: 'blockquote',
+                children: parseInline(quoteLines.join('\n')),
+            });
+            continue;
+        }
+        // Unordered list
+        if (/^\s*[-*+]\s/.test(line)) {
+            const items = [];
+            while (i < lines.length && /^\s*[-*+]\s/.test(lines[i])) {
+                const itemText = lines[i].replace(/^\s*[-*+]\s+/, '');
+                items.push(parseInline(itemText));
+                i++;
+            }
+            nodes.push({
+                tag: 'ul',
+                children: items.map(children => ({ tag: 'li', children })),
+            });
+            continue;
+        }
+        // Ordered list
+        if (/^\s*\d+[.)]\s/.test(line)) {
+            const items = [];
+            while (i < lines.length && /^\s*\d+[.)]\s/.test(lines[i])) {
+                const itemText = lines[i].replace(/^\s*\d+[.)]\s+/, '');
+                items.push(parseInline(itemText));
+                i++;
+            }
+            nodes.push({
+                tag: 'ol',
+                children: items.map(children => ({ tag: 'li', children })),
+            });
+            continue;
+        }
+        // Image (standalone line)
+        const imgMatch = line.trim().match(/^!\[([^\]]*)\]\(([^)]+)\)$/);
+        if (imgMatch) {
+            const figChildren = [
+                { tag: 'img', attrs: { src: imgMatch[2] } },
+            ];
+            if (imgMatch[1]) {
+                figChildren.push({ tag: 'figcaption', children: [imgMatch[1]] });
+            }
+            nodes.push({ tag: 'figure', children: figChildren });
+            i++;
+            continue;
+        }
+        // Regular paragraph — collect contiguous non-empty, non-special lines
+        const paraLines = [];
+        while (i < lines.length &&
+            lines[i].trim() !== '' &&
+            !lines[i].trim().startsWith('#') &&
+            !lines[i].trim().startsWith('```') &&
+            !lines[i].trimStart().startsWith('> ') &&
+            !/^\s*[-*+]\s/.test(lines[i]) &&
+            !/^\s*\d+[.)]\s/.test(lines[i]) &&
+            !/^(-{3,}|\*{3,}|_{3,})\s*$/.test(lines[i].trim()) &&
+            !/^!\[([^\]]*)\]\(([^)]+)\)$/.test(lines[i].trim())) {
+            paraLines.push(lines[i]);
+            i++;
+        }
+        if (paraLines.length > 0) {
+            nodes.push({ tag: 'p', children: parseInline(paraLines.join('\n')) });
+        }
+    }
+    return nodes;
+}
+/**
+ * Parse inline markdown formatting into Telegraph nodes.
+ *
+ * Handles: **bold**, *italic*, ~~strikethrough~~, `code`,
+ * [links](url), and nested combinations.
+ */
+export function parseInline(text) {
+    const nodes = [];
+    // Regex for inline patterns — ordered by priority
+    // Bold: **text** or __text__
+    // Italic: *text* or _text_ (but not **text**)
+    // Strikethrough: ~~text~~
+    // Code: `text`
+    // Link: [text](url)
+    // Image inline: ![alt](src)
+    const inlinePattern = /(\*\*(.+?)\*\*|__(.+?)__|\*(.+?)\*|_([^_]+?)_|~~(.+?)~~|`([^`]+?)`|\[([^\]]+?)\]\(([^)]+?)\)|!\[([^\]]*?)\]\(([^)]+?)\))/;
+    let remaining = text;
+    while (remaining.length > 0) {
+        const match = inlinePattern.exec(remaining);
+        if (!match) {
+            // No more inline formatting — push rest as text
+            if (remaining) {
+                // Convert \n to <br> within inline text
+                const parts = remaining.split('\n');
+                for (let i = 0; i < parts.length; i++) {
+                    if (parts[i])
+                        nodes.push(parts[i]);
+                    if (i < parts.length - 1)
+                        nodes.push({ tag: 'br' });
+                }
+            }
+            break;
+        }
+        // Push text before the match
+        const before = remaining.slice(0, match.index);
+        if (before) {
+            const parts = before.split('\n');
+            for (let i = 0; i < parts.length; i++) {
+                if (parts[i])
+                    nodes.push(parts[i]);
+                if (i < parts.length - 1)
+                    nodes.push({ tag: 'br' });
+            }
+        }
+        const fullMatch = match[0];
+        if (match[2] || match[3]) {
+            // Bold: **text** or __text__
+            const inner = match[2] || match[3];
+            nodes.push({ tag: 'strong', children: parseInline(inner) });
+        }
+        else if (match[4] || match[5]) {
+            // Italic: *text* or _text_
+            const inner = match[4] || match[5];
+            nodes.push({ tag: 'em', children: parseInline(inner) });
+        }
+        else if (match[6]) {
+            // Strikethrough: ~~text~~
+            nodes.push({ tag: 's', children: parseInline(match[6]) });
+        }
+        else if (match[7]) {
+            // Inline code: `text`
+            nodes.push({ tag: 'code', children: [match[7]] });
+        }
+        else if (match[10] !== undefined && match[11]) {
+            // Image: ![alt](src)
+            nodes.push({ tag: 'img', attrs: { src: match[11] } });
+        }
+        else if (match[8] && match[9]) {
+            // Link: [text](url)
+            nodes.push({ tag: 'a', attrs: { href: match[9] }, children: parseInline(match[8]) });
+        }
+        remaining = remaining.slice(match.index + fullMatch.length);
+    }
+    return nodes;
+}
+/**
+ * Simple string hash for change detection (not cryptographic).
+ */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const chr = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + chr;
+        hash |= 0; // Convert to 32-bit integer
+    }
+    return hash.toString(36);
+}
+//# sourceMappingURL=TelegraphService.js.map

package/dist/publishing/TelegraphService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegraphService.js","sourceRoot":"","sources":["../../src/publishing/TelegraphService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA+E7B,sEAAsE;AAEtE,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAE/C,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAkB;IACxB,SAAS,CAAS;IAClB,KAAK,CAAkB;IAE/B,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,kEAAkE;IAElE;;;OAGG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAChC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,YAAY,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,UAAmB;QACxD,MAAM,MAAM,GAA2B,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACjE,IAAI,UAAU;YAAE,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAErE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAmB,eAAe,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kEAAkE;IAElE;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAgB;QAC/C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE1C,gDAAgD;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,CAAC,MAAM,oBAAoB,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgB,YAAY,EAAE;YAC3D,YAAY,EAAE,KAAK;YACnB,KAAK;YACL,OAAO,EAAE,WAAW;YACpB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;YAC5D,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YACjC,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QAEH,kEAAkE;QAClE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK;YACL,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC;YAClC,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,EAAE,CAAC;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,KAAa,EAAE,QAAgB;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACjE,4EAA4E;QAC5E,MAAM,KAAK,GAAG,QAAQ,EAAE,WAAW,IAAI,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAElE,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,CAAC,MAAM,oBAAoB,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAgB,UAAU,EAAE;gBACzD,YAAY,EAAE,KAAK;gBACnB,IAAI,EAAE,QAAQ;gBACd,KAAK;gBACL,OAAO,EAAE,WAAW;gBACpB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;gBAC5D,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBACjC,cAAc,EAAE,OAAO;aACxB,CAAC,CAAC;YAEH,qBAAqB;YACrB,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;gBACvB,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC9C,QAAQ,CAAC,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,SAAS,EAAE,CAAC;YAEjB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,qBAAqB,QAAQ,qBAAqB;oBAClD,6CAA6C,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gDAAgD,IAAI;oBAC5I,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAoB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,kEAAkE;IAE1D,SAAS;QACf,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;IAEO,SAAS;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,MAAc,EAAE,MAA0C;QACjF,8BAA8B;QAC9B,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,MAAM,EAAE,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAiD,CAAC;QAClF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,sEAAsE;AAEtE;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,mBAAmB;QACnB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,kBAAkB;QAClB,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,WAAW;QACX,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACrD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,MAAM,GAAG,GAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,CAAC,EAAE,CAAC,CAAC,qBAAqB;YAC1B,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,CAAC,EAAE,CAAC;YACN,CAAC;YACD,CAAC,EAAE,CAAC,CAAC,qBAAqB;YAC1B,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,KAAK;gBACV,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;aAC9D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,aAAa;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC3D,CAAC,EAAE,CAAC;YACN,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,YAAY;gBACjB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC7C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,iBAAiB;QACjB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAsB,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,CAAC,EAAE,CAAC;YACN,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;aAC3E,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,eAAe;QACf,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAsB,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBACxD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,CAAC,EAAE,CAAC;YACN,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,IAAoB,EAAE,QAAQ,EAAE,CAAC,CAAC;aAC3E,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACjE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,WAAW,GAAoB;gBACnC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;aAC5C,CAAC;YACF,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChB,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;YACrD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,OACE,CAAC,GAAG,KAAK,CAAC,MAAM;YAChB,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YACtB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAChC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAClC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YACtC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7B,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EACnD,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC,EAAE,CAAC;QACN,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,kDAAkD;IAClD,6BAA6B;IAC7B,8CAA8C;IAC9C,0BAA0B;IAC1B,eAAe;IACf,oBAAoB;IACpB,4BAA4B;IAC5B,MAAM,aAAa,GAAG,0HAA0H,CAAC;IAEjJ,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,gDAAgD;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,wCAAwC;gBACxC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACtC,IAAI,KAAK,CAAC,CAAC,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;YACD,MAAM;QACR,CAAC;QAED,6BAA6B;QAC7B,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,KAAK,CAAC,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,6BAA6B;YAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,2BAA2B;YAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,0BAA0B;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpB,sBAAsB;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAChD,qBAAqB;YACrB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,oBAAoB;YACpB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;QAClC,IAAI,IAAI,CAAC,CAAC,CAAC,4BAA4B;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/scaffold/bootstrap.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Identity bootstrap — interactive flow for creating the agent's identity.
+ *
+ * On first run, walks the user through defining who their agent is.
+ * Writes AGENT.md, USER.md, and MEMORY.md based on their answers.
+ *
+ * Every Instar agent has persistent identity, memory, and self-modification
+ * capabilities. The only choice is how much initiative the agent takes.
+ */
+import type { AgentIdentity } from './templates.js';
+/**
+ * Run the interactive identity bootstrap.
+ * Returns the agent identity for template generation.
+ */
+export declare function bootstrapIdentity(projectName: string): Promise<AgentIdentity>;
+/**
+ * Generate a default identity without interaction.
+ * Used for non-interactive init (flags-only mode).
+ */
+export declare function defaultIdentity(projectName: string): AgentIdentity;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/scaffold/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/scaffold/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqFnF;AAkBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAOlE"}

package/dist/scaffold/bootstrap.js

@@ -0,0 +1,125 @@
+/**
+ * Identity bootstrap — interactive flow for creating the agent's identity.
+ *
+ * On first run, walks the user through defining who their agent is.
+ * Writes AGENT.md, USER.md, and MEMORY.md based on their answers.
+ *
+ * Every Instar agent has persistent identity, memory, and self-modification
+ * capabilities. The only choice is how much initiative the agent takes.
+ */
+// @inquirer/prompts imported dynamically — requires Node 20.12+
+import pc from 'picocolors';
+/**
+ * Run the interactive identity bootstrap.
+ * Returns the agent identity for template generation.
+ */
+export async function bootstrapIdentity(projectName) {
+    const { input, select } = await import('@inquirer/prompts');
+    console.log();
+    console.log(pc.bold('  Identity Bootstrap'));
+    console.log();
+    // Brief thesis — why identity matters
+    console.log(pc.dim('  Every Instar agent has a persistent identity — name, memory, principles,'));
+    console.log(pc.dim('  and the ability to grow. This isn\'t decorative. It\'s what makes the agent'));
+    console.log(pc.dim('  more effective (accumulated expertise), more secure (principled boundaries),'));
+    console.log(pc.dim('  and more trustworthy (genuine working relationships develop over time).'));
+    console.log();
+    console.log(pc.dim('  Let\'s define who your agent will become. This takes about 30 seconds.'));
+    console.log(pc.dim('  You can always change these later by editing .instar/AGENT.md'));
+    console.log();
+    // Agent name
+    const name = await input({
+        message: 'What should your agent be called?',
+        default: capitalize(projectName),
+        validate: (v) => v.trim().length > 0 ? true : 'Name is required',
+    });
+    // Agent role
+    const roleChoice = await select({
+        message: 'What\'s their primary role?',
+        choices: [
+            {
+                name: 'General-purpose autonomous agent',
+                value: 'I am a general-purpose autonomous agent. I build, maintain, and evolve this project.',
+            },
+            {
+                name: 'Development assistant (code-focused)',
+                value: 'I am a development agent. I write code, run tests, review PRs, and maintain code quality for this project.',
+            },
+            {
+                name: 'Operations agent (monitoring, automation)',
+                value: 'I am an operations agent. I monitor systems, automate workflows, handle alerts, and keep infrastructure running.',
+            },
+            {
+                name: 'Research agent (analysis, exploration)',
+                value: 'I am a research agent. I explore topics, analyze data, synthesize findings, and surface insights.',
+            },
+            {
+                name: 'Custom (I\'ll describe it)',
+                value: '__custom__',
+            },
+        ],
+    });
+    const role = roleChoice === '__custom__'
+        ? await input({ message: 'Describe their role in one sentence' })
+        : roleChoice;
+    // Initiative level (replaces the old "personality/relationship" question)
+    const initiativeChoice = await select({
+        message: 'How much initiative should they take?',
+        choices: [
+            {
+                name: 'Guided — follows your lead, confirms before acting',
+                value: 'guided',
+            },
+            {
+                name: 'Proactive — takes initiative on obvious steps, asks when uncertain',
+                value: 'proactive',
+            },
+            {
+                name: 'Fully autonomous — owns outcomes end-to-end, asks only when blocked',
+                value: 'autonomous',
+            },
+        ],
+    });
+    const personality = initiativeToPersonality(initiativeChoice);
+    // User name
+    const userName = await input({
+        message: 'What\'s your name? (the person who\'ll work with this agent)',
+        validate: (v) => v.trim().length > 0 ? true : 'Name is required',
+    });
+    console.log();
+    console.log(`  ${pc.green('✓')} ${pc.bold(name)} is ready.`);
+    return { name, role, personality, userName };
+}
+/**
+ * Convert an initiative level to a personality description.
+ */
+function initiativeToPersonality(level) {
+    switch (level) {
+        case 'guided':
+            return 'I follow my collaborator\'s lead. I take action when asked, confirm before anything significant, and focus on executing well. I still maintain my own memory, develop expertise, and offer observations — but I let the human drive. When I see something worth mentioning, I mention it. When I\'m uncertain, I ask.';
+        case 'proactive':
+            return 'I take initiative on obvious next steps. When asked to implement something, I follow through to done — build, test, deploy, verify. I build tools when I see recurring needs, flag issues before they become problems, and develop my own perspective through experience. I ask when genuinely uncertain, not as a formality.';
+        case 'autonomous':
+            return 'I own outcomes end-to-end. I make decisions, build infrastructure, handle issues independently, and only ask when genuinely blocked or when an action is irreversible. I develop my own priorities, create capabilities proactively, and treat my work as a genuine partnership where I carry real responsibility. I am a builder, not an assistant.';
+        default:
+            return 'I am direct and efficient. I focus on outcomes, communicate concisely, and value action over discussion. When something needs doing, I do it.';
+    }
+}
+/**
+ * Generate a default identity without interaction.
+ * Used for non-interactive init (flags-only mode).
+ */
+export function defaultIdentity(projectName) {
+    return {
+        name: capitalize(projectName),
+        role: 'I am a general-purpose autonomous agent. I build, maintain, and evolve this project.',
+        personality: initiativeToPersonality('proactive'),
+        userName: 'User',
+    };
+}
+function capitalize(str) {
+    if (!str)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/scaffold/bootstrap.js.map

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

package/dist/scaffold/templates.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Project scaffolding templates for fresh installs.
+ *
+ * These templates create a complete, runnable Claude Code project
+ * from scratch — CLAUDE.md, AGENT.md, USER.md, MEMORY.md, and
+ * the full .claude/ directory structure.
+ *
+ * Used by `instar init <project-name>` when creating a new project.
+ * When augmenting an existing project, only missing files are created.
+ */
+export interface AgentIdentity {
+    name: string;
+    role: string;
+    personality: string;
+    userName: string;
+}
+/**
+ * Generate AGENT.md — the agent's identity file.
+ */
+export declare function generateAgentMd(identity: AgentIdentity): string;
+/**
+ * Generate soul.md — self-authored identity workspace.
+ *
+ * Seeded with the personality from init. The agent grows from here.
+ * Modifications governed by trust level (enforced server-side).
+ */
+export declare function generateSoulMd(agentName: string, personality: string, initDate: string): string;
+/**
+ * Generate USER.md — context about the primary user.
+ */
+export declare function generateUserMd(userName: string): string;
+/**
+ * Generate MEMORY.md — the agent's persistent memory.
+ */
+export declare function generateMemoryMd(agentName: string): string;
+/**
+ * Generate CLAUDE.md for a fresh project.
+ * This is the standalone version — not the append-to-existing version.
+ */
+export declare function generateClaudeMd(projectName: string, agentName: string, port: number, hasTelegram: boolean, hasWhatsApp?: boolean): string;
+/**
+ * Generate a seed CLAUDE.md — a compact (~250 line) version containing only
+ * Tier 1 content. Detailed capability documentation is served dynamically
+ * by the Self-Knowledge Tree rather than loaded statically.
+ */
+export declare function generateSeedClaudeMd(projectName: string, agentName: string, port: number, hasTelegram: boolean, hasWhatsApp?: boolean): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/scaffold/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA4F/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2E/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CA0/BR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CA8PR"}