skyloom 1.16.1 → 1.17.0

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Code diagnostics — the LSP capability that matters most to an agent: surface
+ * real type/lint errors (with line:col) so the model fixes root causes instead
+ * of guessing.
+ *
+ * Strategy, in order:
+ *   1. TS/JS  → the TypeScript compiler API, resolved from the user's workspace
+ *               node_modules (then sky's own). Real semantic diagnostics, no
+ *               language server to install.
+ *   2. other  → a configured external checker command (config.diagnostics map
+ *               of `ext -> "cmd {file}"`), output parsed for `file:line:col msg`.
+ *
+ * This is intentionally not a full LSP client (hover/goto/rename); it delivers
+ * the diagnostics that close the agent's edit→verify loop on a per-file basis.
+ */
+export type Severity = 'error' | 'warning' | 'info';
+export interface Diagnostic {
+    line: number;
+    column: number;
+    severity: Severity;
+    message: string;
+    code?: string;
+    source?: string;
+}
+/** Semantic + syntactic diagnostics for one TS/JS file via the compiler API. */
+export declare function getTypeScriptDiagnostics(file: string, cwd?: string): Diagnostic[] | {
+    unavailable: string;
+};
+/** Parse generic `path:line:col: message` style compiler/linter output. */
+export declare function parseDiagnosticOutput(output: string, source: string): Diagnostic[];
+/**
+ * Get diagnostics for a file. `config.diagnostics` is an optional map of
+ * `ext -> command` for non-TS languages (e.g. { py: "ruff check {file}" }).
+ */
+export declare function getDiagnostics(file: string, config?: any, cwd?: string): Diagnostic[] | {
+    unavailable: string;
+};
+export declare function formatDiagnostics(file: string, diags: Diagnostic[]): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,UAAU,EAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAkD1H;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAelF;AAiBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,GAAE,MAAsB,GAAG,UAAU,EAAE,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAa9H;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAY3E"}

package/dist/core/diagnostics.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Code diagnostics — the LSP capability that matters most to an agent: surface
+ * real type/lint errors (with line:col) so the model fixes root causes instead
+ * of guessing.
+ *
+ * Strategy, in order:
+ *   1. TS/JS  → the TypeScript compiler API, resolved from the user's workspace
+ *               node_modules (then sky's own). Real semantic diagnostics, no
+ *               language server to install.
+ *   2. other  → a configured external checker command (config.diagnostics map
+ *               of `ext -> "cmd {file}"`), output parsed for `file:line:col msg`.
+ *
+ * This is intentionally not a full LSP client (hover/goto/rename); it delivers
+ * the diagnostics that close the agent's edit→verify loop on a per-file basis.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTypeScriptDiagnostics = getTypeScriptDiagnostics;
+exports.parseDiagnosticOutput = parseDiagnosticOutput;
+exports.getDiagnostics = getDiagnostics;
+exports.formatDiagnostics = formatDiagnostics;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const logger_1 = require("./logger");
+const log = (0, logger_1.getLogger)('diagnostics');
+const TS_EXTS = new Set(['.ts', '.tsx', '.mts', '.cts', '.js', '.jsx', '.mjs', '.cjs']);
+/** Resolve the TypeScript module the way an LSP would: workspace first. */
+function loadTypescript(cwd) {
+    const bases = [cwd, process.cwd(), __dirname];
+    for (const base of bases) {
+        try {
+            const p = require.resolve('typescript', { paths: [base] });
+            return require(p);
+        }
+        catch { /* try next */ }
+    }
+    try {
+        return require('typescript');
+    }
+    catch {
+        return null;
+    }
+}
+function findNearest(file, name) {
+    let dir = path.dirname(path.resolve(file));
+    for (let i = 0; i < 40; i++) {
+        const candidate = path.join(dir, name);
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/** Semantic + syntactic diagnostics for one TS/JS file via the compiler API. */
+function getTypeScriptDiagnostics(file, cwd = process.cwd()) {
+    const ts = loadTypescript(cwd);
+    if (!ts)
+        return { unavailable: 'typescript not installed in workspace or sky — cannot type-check.' };
+    const abs = path.resolve(file);
+    let options = { allowJs: true, checkJs: false, noEmit: true, skipLibCheck: true };
+    let fileNames = [abs];
+    const tsconfig = findNearest(abs, 'tsconfig.json');
+    if (tsconfig) {
+        try {
+            const read = ts.readConfigFile(tsconfig, ts.sys.readFile);
+            const parsed = ts.parseJsonConfigFileContent(read.config || {}, ts.sys, path.dirname(tsconfig));
+            options = { ...parsed.options, noEmit: true };
+            // Keep the project's file set so cross-file types resolve, but ensure our
+            // target is included.
+            fileNames = parsed.fileNames.includes(abs) ? parsed.fileNames : [...parsed.fileNames, abs];
+        }
+        catch (e) {
+            log.warn('tsconfig_parse_failed', { tsconfig, error: String(e) });
+        }
+    }
+    let program;
+    try {
+        program = ts.createProgram(fileNames, options);
+    }
+    catch (e) {
+        return { unavailable: `failed to build TypeScript program: ${e}` };
+    }
+    const source = program.getSourceFile(abs);
+    if (!source)
+        return { unavailable: `file not part of the TypeScript program: ${abs}` };
+    const raw = [
+        ...program.getSyntacticDiagnostics(source),
+        ...program.getSemanticDiagnostics(source),
+    ];
+    const out = [];
+    for (const d of raw) {
+        const message = ts.flattenDiagnosticMessageText(d.messageText, '\n');
+        let line = 1, column = 1;
+        if (d.file && typeof d.start === 'number') {
+            const pos = d.file.getLineAndCharacterOfPosition(d.start);
+            line = pos.line + 1;
+            column = pos.character + 1;
+        }
+        const severity = d.category === 1 ? 'error' : d.category === 0 ? 'warning' : 'info';
+        out.push({ line, column, severity, message, code: d.code ? `TS${d.code}` : undefined, source: 'ts' });
+    }
+    out.sort((a, b) => a.line - b.line || a.column - b.column);
+    return out;
+}
+/** Parse generic `path:line:col: message` style compiler/linter output. */
+function parseDiagnosticOutput(output, source) {
+    const out = [];
+    const re = /^(.*?):(\d+):(\d+):?\s*(error|warning|info)?:?\s*(.*)$/gim;
+    let m;
+    while ((m = re.exec(output)) !== null) {
+        const sev = (m[4] || 'error').toLowerCase();
+        out.push({
+            line: parseInt(m[2], 10) || 1,
+            column: parseInt(m[3], 10) || 1,
+            severity: sev === 'warning' || sev === 'info' ? sev : 'error',
+            message: (m[5] || '').trim(),
+            source,
+        });
+    }
+    return out;
+}
+/** Run a configured external checker for a non-TS file. */
+function getExternalDiagnostics(file, command) {
+    const cmd = command.includes('{file}')
+        ? command.replace(/\{file\}/g, JSON.stringify(file))
+        : `${command} ${JSON.stringify(file)}`;
+    let output = '';
+    try {
+        output = (0, child_process_1.execSync)(cmd, { encoding: 'utf8', timeout: 60000, stdio: ['ignore', 'pipe', 'pipe'] });
+    }
+    catch (e) {
+        // Linters exit non-zero when they find problems — that's the normal path.
+        output = `${e.stdout || ''}\n${e.stderr || ''}`;
+    }
+    return parseDiagnosticOutput(output, command.split(/\s+/)[0]);
+}
+/**
+ * Get diagnostics for a file. `config.diagnostics` is an optional map of
+ * `ext -> command` for non-TS languages (e.g. { py: "ruff check {file}" }).
+ */
+function getDiagnostics(file, config, cwd = process.cwd()) {
+    const abs = path.resolve(file);
+    if (!fs.existsSync(abs))
+        return { unavailable: `file not found: ${abs}` };
+    const ext = path.extname(abs).toLowerCase();
+    const map = (config?.diagnostics || {});
+    const extKey = ext.replace(/^\./, '');
+    // Explicit user config wins.
+    if (map[extKey])
+        return getExternalDiagnostics(abs, map[extKey]);
+    if (TS_EXTS.has(ext))
+        return getTypeScriptDiagnostics(abs, cwd);
+    return { unavailable: `no diagnostics provider for '${ext}'. Configure one in config.yaml diagnostics: { ${extKey || 'ext'}: "<checker> {file}" }` };
+}
+function formatDiagnostics(file, diags) {
+    if (diags.length === 0)
+        return `✓ ${file} — no diagnostics (clean).`;
+    const errs = diags.filter(d => d.severity === 'error').length;
+    const warns = diags.filter(d => d.severity === 'warning').length;
+    const head = `${file} — ${errs} error${errs !== 1 ? 's' : ''}, ${warns} warning${warns !== 1 ? 's' : ''}:`;
+    const lines = diags.slice(0, 100).map(d => {
+        const mark = d.severity === 'error' ? '✗' : d.severity === 'warning' ? '⚠' : 'ℹ';
+        const code = d.code ? ` ${d.code}` : '';
+        return `  ${mark} ${d.line}:${d.column}${code} — ${d.message.replace(/\n/g, ' ')}`;
+    });
+    const more = diags.length > 100 ? `\n  …and ${diags.length - 100} more` : '';
+    return `${head}\n${lines.join('\n')}${more}`;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

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

package/dist/core/diff.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Minimal line-based unified diff for edit previews.
+ *
+ * Edits applied by edit_file are localized (a contiguous region changes), so a
+ * single trimmed hunk — common prefix/suffix removed, the differing middle
+ * shown with a few lines of context — is enough to let the model and the user
+ * see exactly what changed without diffing whole files line-by-line.
+ */
+export interface DiffOptions {
+    /** Lines of unchanged context around the change (default 3). */
+    context?: number;
+    /** Optional path shown in the diff header. */
+    path?: string;
+}
+export interface DiffStat {
+    added: number;
+    removed: number;
+}
+/** Result of rendering a diff: the text plus +/- line counts. */
+export interface DiffResult {
+    text: string;
+    stat: DiffStat;
+}
+/**
+ * Produce a compact unified diff between two strings. Returns the diff text and
+ * a +/- line stat. Identical inputs yield an empty diff (stat 0/0).
+ */
+export declare function unifiedDiff(oldStr: string, newStr: string, opts?: DiffOptions): DiffResult;
+/** Count non-overlapping occurrences of `needle` in `haystack`. */
+export declare function countOccurrences(haystack: string, needle: string): number;
+//# sourceMappingURL=diff.d.ts.map

package/dist/core/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/core/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;CAChB;AAgBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,CAwC9F;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASzE"}

package/dist/core/diff.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Minimal line-based unified diff for edit previews.
+ *
+ * Edits applied by edit_file are localized (a contiguous region changes), so a
+ * single trimmed hunk — common prefix/suffix removed, the differing middle
+ * shown with a few lines of context — is enough to let the model and the user
+ * see exactly what changed without diffing whole files line-by-line.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unifiedDiff = unifiedDiff;
+exports.countOccurrences = countOccurrences;
+function commonPrefixLen(a, b) {
+    const n = Math.min(a.length, b.length);
+    let i = 0;
+    while (i < n && a[i] === b[i])
+        i++;
+    return i;
+}
+function commonSuffixLen(a, b, skip) {
+    const max = Math.min(a.length, b.length) - skip;
+    let i = 0;
+    while (i < max && a[a.length - 1 - i] === b[b.length - 1 - i])
+        i++;
+    return i;
+}
+/**
+ * Produce a compact unified diff between two strings. Returns the diff text and
+ * a +/- line stat. Identical inputs yield an empty diff (stat 0/0).
+ */
+function unifiedDiff(oldStr, newStr, opts = {}) {
+    if (oldStr === newStr)
+        return { text: '', stat: { added: 0, removed: 0 } };
+    const context = Math.max(0, opts.context ?? 3);
+    const oldLines = oldStr.split('\n');
+    const newLines = newStr.split('\n');
+    let pre = commonPrefixLen(oldLines, newLines);
+    const suf = commonSuffixLen(oldLines, newLines, pre);
+    // The changed region (exclusive of the common prefix/suffix).
+    const oldChanged = oldLines.slice(pre, oldLines.length - suf);
+    const newChanged = newLines.slice(pre, newLines.length - suf);
+    // Context window bounds.
+    const ctxStart = Math.max(0, pre - context);
+    const oldCtxAfterStart = oldLines.length - suf;
+    const newCtxAfterStart = newLines.length - suf;
+    const oldCtxAfter = oldLines.slice(oldCtxAfterStart, oldCtxAfterStart + context);
+    const leading = oldLines.slice(ctxStart, pre);
+    const lines = [];
+    if (opts.path)
+        lines.push(`--- ${opts.path}`, `+++ ${opts.path}`);
+    // Hunk header (1-based line numbers).
+    const oldStart = ctxStart + 1;
+    const oldCount = leading.length + oldChanged.length + oldCtxAfter.length;
+    const newStart = ctxStart + 1;
+    const newCount = leading.length + newChanged.length + oldCtxAfter.length;
+    lines.push(`@@ -${oldStart},${oldCount} +${newStart},${newCount} @@`);
+    for (const l of leading)
+        lines.push(` ${l}`);
+    for (const l of oldChanged)
+        lines.push(`-${l}`);
+    for (const l of newChanged)
+        lines.push(`+${l}`);
+    for (const l of oldCtxAfter)
+        lines.push(` ${l}`);
+    return {
+        text: lines.join('\n'),
+        stat: { added: newChanged.length, removed: oldChanged.length },
+    };
+}
+/** Count non-overlapping occurrences of `needle` in `haystack`. */
+function countOccurrences(haystack, needle) {
+    if (!needle)
+        return 0;
+    let count = 0;
+    let idx = haystack.indexOf(needle);
+    while (idx !== -1) {
+        count++;
+        idx = haystack.indexOf(needle, idx + needle.length);
+    }
+    return count;
+}
+//# sourceMappingURL=diff.js.map

package/dist/core/diff.js.map

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

package/dist/core/envcontext.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Environment context snapshot — a small, model-visible block describing the
+ * runtime world (working directory, platform, git, Node, date), kept separate
+ * from conversation history. Mirrors Claude Code's <env> block so the agent
+ * grounds itself without having to probe with tools every turn.
+ */
+export interface GitInfo {
+    repo: boolean;
+    branch?: string;
+}
+/**
+ * Cheap git detection: walk up for a `.git` (handles worktrees, where `.git`
+ * is a file pointing at the real gitdir), then read HEAD for the branch. No
+ * subprocess — just file reads.
+ */
+export declare function gitInfo(cwd?: string): GitInfo;
+/**
+ * Build the environment block. `now` is injectable for deterministic tests.
+ */
+export declare function buildEnvBlock(opts?: {
+    cwd?: string;
+    lang?: string;
+    now?: Date;
+}): string;
+//# sourceMappingURL=envcontext.d.ts.map

package/dist/core/envcontext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envcontext.d.ts","sourceRoot":"","sources":["../../src/core/envcontext.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAyB5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GAAG,MAAM,CA2BxF"}

package/dist/core/envcontext.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Environment context snapshot — a small, model-visible block describing the
+ * runtime world (working directory, platform, git, Node, date), kept separate
+ * from conversation history. Mirrors Claude Code's <env> block so the agent
+ * grounds itself without having to probe with tools every turn.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitInfo = gitInfo;
+exports.buildEnvBlock = buildEnvBlock;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Cheap git detection: walk up for a `.git` (handles worktrees, where `.git`
+ * is a file pointing at the real gitdir), then read HEAD for the branch. No
+ * subprocess — just file reads.
+ */
+function gitInfo(cwd = process.cwd()) {
+    let dir = path.resolve(cwd);
+    for (let i = 0; i < 40; i++) {
+        const dotGit = path.join(dir, '.git');
+        if (fs.existsSync(dotGit)) {
+            let gitDir = dotGit;
+            try {
+                if (fs.statSync(dotGit).isFile()) {
+                    const m = fs.readFileSync(dotGit, 'utf8').match(/gitdir:\s*(.+)/);
+                    if (m)
+                        gitDir = path.resolve(dir, m[1].trim());
+                }
+            }
+            catch { /* treat as repo without branch */ }
+            try {
+                const head = fs.readFileSync(path.join(gitDir, 'HEAD'), 'utf8').trim();
+                const ref = head.match(/ref:\s*refs\/heads\/(.+)/);
+                return { repo: true, branch: ref ? ref[1] : head.slice(0, 8) };
+            }
+            catch {
+                return { repo: true };
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return { repo: false };
+}
+/**
+ * Build the environment block. `now` is injectable for deterministic tests.
+ */
+function buildEnvBlock(opts) {
+    const cwd = opts?.cwd || process.cwd();
+    const lang = opts?.lang || 'zh';
+    const now = opts?.now || new Date();
+    const git = gitInfo(cwd);
+    const date = now.toISOString().slice(0, 10);
+    const platform = `${process.platform} ${os.release()}`;
+    const gitLine = git.repo ? (git.branch ? `yes (branch: ${git.branch})` : 'yes') : 'no';
+    if (lang === 'en') {
+        return [
+            '## Environment',
+            `- Working directory: ${cwd}`,
+            `- Platform: ${platform}`,
+            `- Node: ${process.version}`,
+            `- Git repo: ${gitLine}`,
+            `- Date: ${date}`,
+        ].join('\n');
+    }
+    return [
+        '## 运行环境',
+        `- 工作目录: ${cwd}`,
+        `- 平台: ${platform}`,
+        `- Node: ${process.version}`,
+        `- Git 仓库: ${gitLine === 'no' ? '否' : gitLine.replace('yes', '是')}`,
+        `- 日期: ${date}`,
+    ].join('\n');
+}
+//# sourceMappingURL=envcontext.js.map

package/dist/core/envcontext.js.map

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

package/dist/core/factory.d.ts

@@ -17,6 +17,7 @@ export declare class SystemContext {
     workspacePath: string;
     mcp: any;
     mcpStatus: string[];
+    plugins: any;
     constructor(opts: {
         config: ReturnType<typeof loadConfig>;
         bus: MessageBus;
@@ -26,6 +27,7 @@ export declare class SystemContext {
         workspacePath?: string;
         mcp?: any;
         mcpStatus?: string[];
+        plugins?: any;
     });
     initAll(): Promise<void>;
     closeAll(): Promise<void>;

package/dist/core/factory.d.ts.map

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

package/dist/core/factory.js

@@ -21,6 +21,7 @@ class SystemContext {
         this.workspacePath = '';
         this.mcp = null;
         this.mcpStatus = [];
+        this.plugins = null;
         this.config = opts.config;
         this.bus = opts.bus;
         this.llm = opts.llm;
@@ -29,8 +30,18 @@ class SystemContext {
         this.workspacePath = opts.workspacePath || '';
         this.mcp = opts.mcp || null;
         this.mcpStatus = opts.mcpStatus || [];
+        this.plugins = opts.plugins || null;
     }
     async initAll() {
+        // Plugin `init` hook — fires once after load, before agents come up.
+        if (this.plugins) {
+            try {
+                await this.plugins.emit('init', { config: this.config });
+            }
+            catch (e) {
+                log.warn('plugin_init_hook_failed', { error: String(e) });
+            }
+        }
         if (this.mcp) {
             try {
                 this.mcpStatus = await this.mcp.connectAll();
@@ -47,6 +58,12 @@ class SystemContext {
         }
     }
     async closeAll() {
+        // Terminate any background shell jobs started this session.
+        try {
+            const { getBackgroundManager } = require('./bgproc');
+            getBackgroundManager().killAll();
+        }
+        catch { /* best-effort */ }
         for (const agent of this.agentMap.values()) {
             await agent.close();
         }
@@ -103,10 +120,11 @@ function createSystemContext() {
     catch (e) {
         log.warn('skills_not_available', { error: String(e) });
     }
-    // Load plugins
+    // Load plugins (ordered hook lifecycle — see plugins/loader)
+    let pluginLoader = null;
     try {
         const { PluginLoader } = require('../plugins/loader');
-        const pluginLoader = new PluginLoader(baseToolRegistry);
+        pluginLoader = new PluginLoader(baseToolRegistry, config);
         const pluginConfig = config.plugins;
         const pluginDirs = pluginConfig?.enabled ? (pluginConfig.directories || []) : [];
         pluginLoader.loadFromDirectories(pluginDirs);
@@ -173,6 +191,20 @@ function createSystemContext() {
             catch (e) {
                 log.warn('delegate_tool_not_available', { agent: name, error: String(e) });
             }
+            // Register the spawn_agent tool — isolated-context subagents (Task tool).
+            try {
+                const { createSpawnAgentTool } = require('../tools/spawn');
+                agentRegistry.register(createSpawnAgentTool({
+                    config,
+                    llm,
+                    bus,
+                    baseToolRegistry,
+                    baseSkillRegistry,
+                }));
+            }
+            catch (e) {
+                log.warn('spawn_tool_not_available', { agent: name, error: String(e) });
+            }
             // Register model self-service tools (list_models / set_my_model)
             try {
                 const { createModelTools } = require('../tools/model_tool');
@@ -213,6 +245,7 @@ function createSystemContext() {
         toolRegistry: baseToolRegistry,
         workspacePath,
         mcp: mcpManager,
+        plugins: pluginLoader,
     });
 }
 // ── Task orchestration ──