@caupulican/pi-adaptative 0.80.76 → 0.80.78

package/dist/core/agent-session.js

@@ -34,6 +34,7 @@ import { disposeExtensionEventSubscriptions } from "./extensions/loader.js";
 import { emitSessionShutdownEvent } from "./extensions/runner.js";
 import { GatewayRegistry } from "./gateways/channel-provider.js";
 import { decideDemand, ReflectionEngine, } from "./learning/reflection-engine.js";
+import { isPromotedFrontmatter, SkillCurator } from "./learning/skill-curator.js";
 import { EffectivenessTracker } from "./memory/effectiveness-tracker.js";
 import { MemoryManager } from "./memory/memory-manager.js";
 import { FileStoreProvider } from "./memory/providers/file-store.js";
@@ -135,6 +136,8 @@ export class AgentSession {
     _lastCostGuardDecision;
     /** One-shot latch so the cost guard downgrades reasoning once per over-threshold episode, not every call. */
     _costGuardDowngraded = false;
+    /** Lazily-built skill curator (#32) over `<agentDir>/skills`. */
+    _skillCuratorInstance;
     /** Set on dispose so in-flight background reflection bails instead of writing to a dead session (Bug #21). */
     _disposed = false;
     /** Aborts in-flight background reflection completions on dispose (Bug #21). */
@@ -337,6 +340,27 @@ export class AgentSession {
     getLastCostGuardDecision() {
         return this._lastCostGuardDecision;
     }
+    get _skillCurator() {
+        if (!this._skillCuratorInstance) {
+            this._skillCuratorInstance = new SkillCurator(join(this._agentDir, "skills"));
+        }
+        return this._skillCuratorInstance;
+    }
+    /**
+     * Skill curator (#32): PROPOSE (never auto-apply) archival of stale reflection-promoted skills and
+     * consolidation of overlapping ones. The host surfaces these (e.g. a `/curate` command) for approval.
+     */
+    proposeSkillCuration(options) {
+        return this._skillCurator.proposeCuration(Date.now(), options);
+    }
+    /** Archive a promoted skill into `skills/.archive/` (restorable, non-destructive). Returns true if moved. */
+    archivePromotedSkill(name) {
+        return this._skillCurator.archiveSkill(name);
+    }
+    /** Restore a previously-archived promoted skill. Returns true if moved back. */
+    restorePromotedSkill(name) {
+        return this._skillCurator.restoreSkill(name);
+    }
     _installAgentTurnRefresh() {
         const previousPrepareNextTurn = this.agent.prepareNextTurn?.bind(this.agent);
         this.agent.prepareNextTurn = async (signal) => {
@@ -1328,6 +1352,11 @@ export class AgentSession {
             return text; // Unknown or profile-blocked skill, pass through unchanged
         try {
             const content = readFileSync(skill.filePath, "utf-8");
+            // Curator (#32): record use of a reflection-PROMOTED skill so stale ones can later be proposed
+            // for archival. Only promoted skills carry the marker, so hand-authored skills are untouched.
+            if (isPromotedFrontmatter(content)) {
+                this._skillCurator.recordUse(skill.name, Date.now());
+            }
             const body = stripResourceProfileBlocks(stripFrontmatter(content)).trim();
             const skillBlock = `<skill name="${skill.name}" location="${skill.filePath}">\nReferences are relative to ${skill.baseDir}.\n\n${body}\n</skill>`;
             return args ? `${skillBlock}\n\n${args}` : skillBlock;