qlogicagent 2.2.0 → 2.3.0

package/dist/types/orchestration/skill-improvement.d.ts

@@ -1,7 +1,14 @@
 /**
  * Skill self-learning: decides whether a completed turn should
  * trigger skill creation or improvement instructions.
+ *
+ * Guards against proliferation:
+ * - MAX_SKILLS_PER_PROJECT: hard cap on project-level skills
+ * - Dedup check: compares tool-set signature against existing skills
+ * - Cooldown: prevents rapid-fire creation within a session
  */
+import { MAX_SKILLS_PER_PROJECT, MAX_SKILLS_GLOBAL } from "../agent/tunable-defaults.js";
+export { MAX_SKILLS_PER_PROJECT, MAX_SKILLS_GLOBAL };
 export interface SkillTurnResult {
     ok: boolean;
     /** Number of tool invocations in this turn */
@@ -36,6 +43,32 @@ export interface SkillImproveInstruction {
     reason: string;
 }
 export type SkillInstruction = SkillCreateInstruction | SkillImproveInstruction;
+/**
+ * Reset cooldown state (for testing).
+ */
+export declare function resetSkillCreationCooldown(): void;
+/**
+ * Check if an existing skill in skillsDir already covers the same tool set.
+ * Returns the name of the conflicting skill, or null if none found.
+ */
+export declare function findDuplicateSkill(tools: string[], skillsDir: string): string | null;
+/**
+ * Count active skills in a directory.
+ */
+export declare function countSkillsInDir(skillsDir: string): number;
+/**
+ * Context for proliferation checks.
+ */
+export interface SkillCreationContext {
+    /** Project-level skills directory */
+    projectSkillsDir?: string;
+    /** User-level (global) skills directory */
+    globalSkillsDir?: string;
+    /** Tool names used in this turn */
+    tools: string[];
+    /** Optional suggested name */
+    suggestedName?: string;
+}
 /**
  * Determine whether a completed turn should produce a skill instruction.
  *
@@ -44,16 +77,14 @@ export type SkillInstruction = SkillCreateInstruction | SkillImproveInstruction;
  * - It involved multi-step orchestration
  * - It used ≥3 tool calls across ≥2 distinct tools
  * - No existing skill was already applied
- *
- * An improvement is suggested when:
- * - The turn used an existing skill but got negative feedback
+ * - Cooldown has elapsed since last skill creation
+ * - No duplicate skill exists (same tool signature)
+ * - Project skill count < MAX_SKILLS_PER_PROJECT
  */
-export declare function shouldCreateSkill(result: SkillTurnResult): boolean;
+export declare function shouldCreateSkill(result: SkillTurnResult, context?: SkillCreationContext): boolean;
 export declare function shouldImproveSkill(result: SkillTurnResult): boolean;
 /**
  * Build a skill instruction from a turn result, or null if none is warranted.
+ * Updates cooldown timestamp on success.
  */
-export declare function buildSkillInstruction(result: SkillTurnResult, context: {
-    tools: string[];
-    suggestedName?: string;
-}): SkillInstruction | null;
+export declare function buildSkillInstruction(result: SkillTurnResult, context: SkillCreationContext): SkillInstruction | null;

package/dist/types/orchestration/subagent/fork-subagent.d.ts

@@ -9,12 +9,12 @@
  * 5. Depth control via in-memory counter (not DB-based)
  */
 import type { AgentDefinition } from "./agent-registry.js";
+import { MAX_FORK_DEPTH } from "../../agent/tunable-defaults.js";
 /** Sentinel tag injected into fork children to prevent recursive forking. */
 export declare const FORK_SENTINEL_TAG = "<fork-child-context>";
 /** Placeholder text used for all tool_results in shared prefix (ensures byte-identical prefix). */
 export declare const FORK_PLACEHOLDER_RESULT = "Fork started \u2014 processing in background";
-/** Maximum fork depth for in-memory agents (CC: MAX_FORK_DEPTH). */
-export declare const MAX_FORK_DEPTH = 4;
+export { MAX_FORK_DEPTH };
 export interface ForkContext {
     /** Parent's full message history (becomes shared prefix for cache). */
     parentMessages: unknown[];

package/dist/types/protocol/notifications.d.ts

@@ -444,6 +444,22 @@ export interface ProjectSwitchedNotification {
 export interface ProjectDeletedNotification {
     id: string;
 }
+/** A project was renamed. */
+export interface ProjectRenamedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}
+/** A project was archived. */
+export interface ProjectArchivedNotification {
+    id: string;
+}
+/** A project was unarchived (restored). */
+export interface ProjectUnarchivedNotification {
+    id: string;
+    name: string;
+    workspaceDir: string;
+}
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
     "turn.delta": TurnDeltaNotification;
@@ -495,6 +511,9 @@ export interface NotificationMethodMap {
     "project.created": ProjectCreatedNotification;
     "project.switched": ProjectSwitchedNotification;
     "project.deleted": ProjectDeletedNotification;
+    "project.renamed": ProjectRenamedNotification;
+    "project.archived": ProjectArchivedNotification;
+    "project.unarchived": ProjectUnarchivedNotification;
 }
 /** All known notification method names. */
 export type NotificationMethod = keyof NotificationMethodMap;

package/dist/types/runtime/hooks/memory-hooks.d.ts

@@ -2,11 +2,8 @@ import type { HookRegistry } from "../../contracts/hooks.js";
 import type { MemoryProvider } from "qlogicagent-runtime-contracts";
 import type { Memdir } from "../../skills/memory/memdir.js";
 export declare const MEMORY_PREFETCH_CONFIG: {
-    /** Max bytes of memory content to inject per session (CC: 60KB) */
     readonly MAX_SESSION_BYTES: number;
-    /** Max results per recall query */
     readonly LIMIT_PER_RECALL: 10;
-    /** Max entries in surfaced-path LRU set */
     readonly MAX_SURFACED_ENTRIES: 100;
 };
 export interface MemoryHooksDeps {

package/dist/types/runtime/hooks/skill-recall-hooks.d.ts

@@ -1,14 +1,12 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
 export declare const SKILL_RECALL_CONFIG: {
-    /** Max number of cross-project skills to inject per turn. */
     readonly MAX_RECALLED_SKILLS: 3;
-    /** Max chars of skill content to include in recall context. */
     readonly MAX_SKILL_CONTENT_CHARS: 800;
-    /** Cache TTL for known project skill index (ms). */
     readonly CACHE_TTL_MS: number;
 };
 /**
- * Detect whether user message contains retrospective/cross-reference semantics.
+ * Detect whether user message contains retrospective/cross-reference semantics
+ * OR similar-task patterns that could benefit from existing skills.
  * Returns extracted keywords for skill matching if triggered, or null.
  */
 export declare function detectRetrospectiveTrigger(message: string): string[] | null;

package/dist/types/runtime/infra/project-store.d.ts

@@ -22,6 +22,12 @@ export declare function deleteProject(projectId: string): {
     switchedTo?: ProjectInfo;
 };
 export declare function getOrCreateDefaultProject(defaultWorkspaceDir: string): ProjectInfo;
+export declare function renameProject(projectId: string, newName: string): ProjectInfo | null;
+export declare function archiveProject(projectId: string): {
+    archived: boolean;
+    switchedTo?: ProjectInfo;
+};
+export declare function unarchiveProject(projectId: string): ProjectInfo | null;
 export declare function findByGroupId(groupId: string): ProjectInfo | null;
 export declare function archiveByGroupId(groupId: string): {
     archived: boolean;

package/dist/types/runtime/infra/skill-injector.d.ts

@@ -9,8 +9,11 @@
  *
  * 2. **First-message prompt injection**: For agents without native skill
  *    directory support, prepend skill instructions text to the first prompt.
+ *    Subject to a token budget to prevent context bloat.
  */
 import type { AgentCapabilities } from "./acp-types.js";
+import { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT } from "../../agent/tunable-defaults.js";
+export { SKILL_INJECTION_MAX_CHARS, SKILL_INJECTION_MAX_COUNT };
 export declare class SkillInjector {
     /**
      * Synchronize skills to an agent's native skill directory.
@@ -24,6 +27,9 @@ export declare class SkillInjector {
      * Build a skill description block to prepend to the first message
      * for agents that don't support native skill directories.
      *
+     * Respects SKILL_INJECTION_MAX_CHARS and SKILL_INJECTION_MAX_COUNT
+     * to prevent token bloat.
+     *
      * @param cwd - Project working directory (for project-level skills)
      * @returns Markdown text with skill instructions, or empty string if no skills.
      */
@@ -44,8 +50,9 @@ export declare class SkillInjector {
      */
     applySkills(capabilities?: AgentCapabilities, cwd?: string): string;
     /**
-     * Collect all skill file paths from user-level and project-level dirs.
-     * Only `.md` files are treated as skills.
+     * Collect all skill file paths from project-level and user-level dirs.
+     * Skills are stored as `<dir>/<skillName>/SKILL.md`.
+     * Priority: project > global (project listed first for budget-constrained injection).
      */
     private collectSkillPaths;
 }

package/dist/types/skills/skill-system/skill-source.d.ts

@@ -60,6 +60,33 @@ export interface SkillStorageDeps {
     /** Write the registry lock file. */
     writeLockfile(lockfile: SkillLockfile): Promise<void>;
 }
+/**
+ * A single version history entry for a skill.
+ */
+export interface SkillVersionEntry {
+    version: string;
+    updatedAt: string;
+    changelog?: string;
+    /** Integrity hash of the SKILL.md content at this version (sha256). */
+    integrity?: string;
+}
+/**
+ * Usage statistics for a skill.
+ */
+export interface SkillUsageStats {
+    /** Total number of times this skill has been invoked/applied. */
+    invokeCount: number;
+    /** Number of turns where the skill was active and contributed. */
+    activeCount: number;
+    /** Number of times the skill received positive feedback. */
+    positiveCount: number;
+    /** Number of times the skill received negative feedback. */
+    negativeCount: number;
+    /** ISO 8601 timestamp of last use. */
+    lastUsedAt?: string;
+    /** Derived success rate = (invokeCount - negativeCount) / invokeCount */
+    successRate?: number;
+}
 /**
  * Single entry in the skill lockfile.
  */
@@ -71,6 +98,12 @@ export interface SkillLockEntry {
     scanSummary?: SkillScanSummary;
     /** Integrity hash of the SKILL.md content (sha256). */
     integrity?: string;
+    /** Current version (from frontmatter or auto-incremented). */
+    currentVersion?: string;
+    /** Version history — newest first. */
+    versionHistory?: SkillVersionEntry[];
+    /** Usage statistics. */
+    usage?: SkillUsageStats;
 }
 /**
  * Complete lockfile for all installed skills.
@@ -79,6 +112,38 @@ export interface SkillLockfile {
     version: 1;
     entries: Record<string, SkillLockEntry>;
 }
+/**
+ * Record a skill usage event. Mutates the lockfile entry in-place.
+ */
+export declare function recordSkillUsage(lockfile: SkillLockfile, skillName: string, feedback?: "positive" | "negative" | null): void;
+/**
+ * Record a skill version update. Pushes current version to history.
+ */
+export declare function recordSkillVersionUpdate(lockfile: SkillLockfile, skillName: string, newVersion: string, changelog?: string, integrity?: string): void;
+/**
+ * Lightweight per-skill stats stored in `~/.qlogicagent/skill-stats.json`.
+ * This is independent of the lockfile — covers learned, promoted, and installed skills.
+ */
+export interface SkillStatsFile {
+    [skillName: string]: SkillUsageStats;
+}
+/**
+ * Record a skill invocation. Fire-and-forget — never throws.
+ * @param agentHome - path to `~/.qlogicagent/`
+ * @param skillName - the skill that was invoked
+ * @param success - whether the invocation completed without error
+ */
+export declare function trackSkillInvocation(agentHome: string, skillName: string, success: boolean): void;
+/**
+ * Read stats for a skill. Returns undefined if no stats recorded.
+ */
+export declare function getSkillStats(agentHome: string, skillName: string): SkillUsageStats | undefined;
+/**
+ * Get all skill stats. Useful for UI display.
+ */
+export declare function getAllSkillStats(agentHome: string): SkillStatsFile;
+/** Reset cache (for testing). */
+export declare function resetStatsCache(): void;
 /**
  * Result of a skill install operation.
  */

package/dist/types/transport/acp-server.d.ts

@@ -89,6 +89,8 @@ export declare class AcpServer {
     private activeSessionId;
     /** Pending permission requests (agent → host) waiting for response */
     private pendingPermissions;
+    /** Map from outbound JSON-RPC request id → permissionId for response matching */
+    private outboundRequestMap;
     constructor(transport: Transport, handler: AcpRequestHandler, config?: AcpServerConfig);
     /**
      * Route an incoming raw message through ACP protocol handling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",