@soleri/core 9.6.0 → 9.7.1

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgDH;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmD3F"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAgBD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB;IAAE,kBAAkB,EAAE,OAAO,CAAC;IAAC,mBAAmB,EAAE,OAAO,CAAA;CAAE,CAY/D;AAkCD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C3F"}

package/dist/update-check.js

@@ -13,6 +13,38 @@ const CACHE_FILE = join(SOLERI_HOME, 'update-check.json');
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
 const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@soleri/core/latest';
 const FETCH_TIMEOUT_MS = 5_000;
+const CHANGELOG_BASE_URL = 'https://github.com/adrozdenko/soleri/releases/tag';
+/**
+ * Build a changelog URL for a given version.
+ */
+export function buildChangelogUrl(version) {
+    return `${CHANGELOG_BASE_URL}/v${version}`;
+}
+/**
+ * Parse the major version from a semver string (x.y.z).
+ */
+function parseMajor(version) {
+    return Number(version.split('.')[0]) || 0;
+}
+/**
+ * Parse the minor version from a semver string (x.y.z).
+ */
+function parseMinor(version) {
+    return Number(version.split('.')[1]) || 0;
+}
+/**
+ * Detect breaking changes (major version bump) and multi-release jumps (minor +2).
+ */
+export function detectBreakingChanges(currentVersion, latestVersion) {
+    const currentMajor = parseMajor(currentVersion);
+    const latestMajor = parseMajor(latestVersion);
+    const hasBreakingChanges = latestMajor !== currentMajor;
+    const currentMinor = parseMinor(currentVersion);
+    const latestMinor = parseMinor(latestVersion);
+    // Multiple releases: same major but minor jumped by 2+
+    const hasMultipleReleases = !hasBreakingChanges && latestMajor === currentMajor && latestMinor - currentMinor >= 2;
+    return { hasBreakingChanges, hasMultipleReleases };
+}
 function readCache() {
     try {
         if (!existsSync(CACHE_FILE))
@@ -65,8 +97,7 @@ export async function checkForUpdate(agentId, currentVersion) {
     if (cache && Date.now() - cache.checkedAt < CHECK_INTERVAL_MS) {
         // Use cached result
         if (cache.latestVersion && isNewer(currentVersion, cache.latestVersion)) {
-            console.error(`${tag} Update available: @soleri/core ${currentVersion} → ${cache.latestVersion}`);
-            console.error(`${tag} Run: soleri agent update`);
+            emitUpdateNotifications(tag, currentVersion, cache.latestVersion);
         }
         return;
     }
@@ -84,8 +115,7 @@ export async function checkForUpdate(agentId, currentVersion) {
         const latestVersion = data.version ?? null;
         writeCache({ checkedAt: Date.now(), latestVersion });
         if (latestVersion && isNewer(currentVersion, latestVersion)) {
-            console.error(`${tag} Update available: @soleri/core ${currentVersion} → ${latestVersion}`);
-            console.error(`${tag} Run: soleri agent update`);
+            emitUpdateNotifications(tag, currentVersion, latestVersion);
         }
     }
     catch {
@@ -93,4 +123,21 @@ export async function checkForUpdate(agentId, currentVersion) {
         writeCache({ checkedAt: Date.now(), latestVersion: null });
     }
 }
+/**
+ * Emit update notification messages to stderr, including changelog URL
+ * and breaking change / multi-release warnings.
+ */
+function emitUpdateNotifications(tag, currentVersion, latestVersion) {
+    console.error(`${tag} Update available: @soleri/core ${currentVersion} → ${latestVersion}`);
+    console.error(`${tag} Run: soleri agent update`);
+    console.error(`${tag} Changelog: ${buildChangelogUrl(latestVersion)}`);
+    const { hasBreakingChanges, hasMultipleReleases } = detectBreakingChanges(currentVersion, latestVersion);
+    if (hasBreakingChanges) {
+        const latestMajor = latestVersion.split('.')[0];
+        console.error(`${tag} ⚠ Breaking changes in v${latestMajor}.0.0 — see migration guide`);
+    }
+    else if (hasMultipleReleases) {
+        console.error(`${tag} Multiple releases since your version — review changelog`);
+    }
+}
 //# sourceMappingURL=update-check.js.map

package/dist/update-check.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/core",
-  "version": "9.6.0",
+  "version": "9.7.1",
   "description": "Shared engine for Soleri agents — vault, brain, planner, LLM utilities, and facade infrastructure.",
   "keywords": [
     "agent",
@@ -55,9 +55,6 @@
     "yaml": "^2.7.0",
     "zod": "^3.24.2"
   },
-  "optionalDependencies": {
-    "better-sqlite3": "^11.8.1"
-  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/pdf-parse": "^1.1.5",

package/src/index.ts

@@ -366,6 +366,16 @@ export {
 } from './planning/gap-types.js';
 export type { GapSeverity, GapCategory, PlanGap } from './planning/gap-types.js';
 
+// ─── Goal Ancestry ──────────────────────────────────────────────────
+export { GoalAncestry, JsonGoalRepository, generateGoalId } from './planning/goal-ancestry.js';
+export type {
+  GoalLevel,
+  GoalStatus,
+  Goal,
+  GoalStore,
+  GoalRepository,
+} from './planning/goal-ancestry.js';
+
 // ─── Task Complexity Assessor ────────────────────────────────────────
 export { assessTaskComplexity } from './planning/task-complexity-assessor.js';
 export type {
@@ -670,8 +680,23 @@ export type {
   LockfileData,
   ResolvedPack,
   ResolveOptions,
+  TrustLevel,
+  SourceType,
+  SkillInventoryItem,
+  SkillMetadata,
 } from './packs/index.js';
 
+// ─── Skill Trust & Sync ─────────────────────────────────────────────────
+export { classifyTrust, TrustClassifier } from './skills/trust-classifier.js';
+export {
+  discoverSkills,
+  syncSkillsToClaudeCode,
+  classifySkills,
+  checkSkillCompatibility,
+  ApprovalRequiredError,
+} from './skills/sync-skills.js';
+export type { SkillEntry, SyncResult, ClassifySkillsOptions } from './skills/sync-skills.js';
+
 // ─── Plugin System ──────────────────────────────────────────────────────
 export {
   PluginRegistry,
@@ -840,6 +865,21 @@ export type {
   OperatorProfileHistory,
 } from './operator/operator-types.js';
 
+// ─── Session Compaction ─────────────────────────────────────────────
+export type {
+  CompactionPolicy,
+  CompactionResult,
+  SessionState,
+  HandoffNote,
+} from './session/index.js';
+export {
+  ENGINE_DEFAULTS,
+  shouldCompact,
+  parseDuration,
+  resolvePolicy,
+  renderHandoff,
+} from './session/index.js';
+
 // ─── Operator Context (Adaptive Persona) ────────────────────────────
 export { OperatorContextStore } from './operator/operator-context-store.js';
 export { DECLINED_CATEGORIES } from './operator/operator-context-types.js';
@@ -860,3 +900,7 @@ export type {
   ContextItemType,
   DeclinedCategory,
 } from './operator/operator-context-types.js';
+
+// ─── Update Check ────────────────────────────────────────────────────
+export { checkForUpdate, buildChangelogUrl, detectBreakingChanges } from './update-check.js';
+export type { UpdateInfo } from './update-check.js';

package/src/packs/index.ts

@@ -14,6 +14,10 @@ export {
   type InstalledPack,
   type InstallResult,
   type ValidateResult,
+  type TrustLevel,
+  type SourceType,
+  type SkillInventoryItem,
+  type SkillMetadata,
 } from './types.js';
 
 export { PackInstaller } from './pack-installer.js';

package/src/packs/types.ts

@@ -19,6 +19,38 @@
 
 import { z } from 'zod';
 
+// =============================================================================
+// SKILL TRUST & SOURCE TRACKING
+// =============================================================================
+
+/** How much a skill can do — escalates from pure docs to executable code */
+export type TrustLevel = 'markdown_only' | 'assets' | 'scripts';
+
+/** Where a skill came from */
+export type SourceType = 'builtin' | 'pack' | 'local' | 'github' | 'npm';
+
+/** A single file in a skill directory, classified by kind */
+export interface SkillInventoryItem {
+  /** Relative path within the skill directory */
+  path: string;
+  /** What kind of file this is */
+  kind: 'skill' | 'reference' | 'asset' | 'script';
+}
+
+/** Extended metadata for a discovered skill */
+export interface SkillMetadata {
+  /** Computed trust level based on directory contents */
+  trust: TrustLevel;
+  /** Where this skill was sourced from */
+  source: { type: SourceType; uri: string };
+  /** Engine version compatibility check result */
+  compatibility: 'compatible' | 'unknown' | 'invalid';
+  /** Engine version declared by the skill (if any) */
+  engineVersion?: string;
+  /** Classified inventory of all files in the skill directory */
+  inventory: SkillInventoryItem[];
+}
+
 // =============================================================================
 // MANIFEST SCHEMA
 // =============================================================================

package/src/planning/github-projection.ts

@@ -333,6 +333,7 @@ export function formatIssueBody(
   plan: PlanMetadataForIssue,
   taskTitle: string,
   taskDescription: string,
+  options?: { goalContext?: string },
 ): string {
   const lines: string[] = [];
 
@@ -341,6 +342,11 @@ export function formatIssueBody(
   lines.push(`**Objective:** ${plan.objective}`);
   lines.push('');
 
+  if (options?.goalContext) {
+    lines.push(options.goalContext);
+    lines.push('');
+  }
+
   if (plan.decisions.length > 0) {
     lines.push('## Decisions');
     for (const d of plan.decisions) {

package/src/planning/goal-ancestry.test.ts

@@ -0,0 +1,427 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { GoalAncestry, JsonGoalRepository, generateGoalId } from './goal-ancestry.js';
+import type { Goal, GoalRepository } from './goal-ancestry.js';
+import { Planner } from './planner.js';
+import { formatIssueBody } from './github-projection.js';
+
+// ─── In-memory repository for unit tests ──────────────────────────
+
+class InMemoryGoalRepository implements GoalRepository {
+  private goals: Goal[] = [];
+
+  getById(id: string): Goal | null {
+    return this.goals.find((g) => g.id === id) ?? null;
+  }
+
+  getByParentId(parentId: string): Goal[] {
+    return this.goals.filter((g) => g.parentId === parentId);
+  }
+
+  create(goal: Omit<Goal, 'createdAt' | 'updatedAt'>): Goal {
+    const now = Date.now();
+    const full: Goal = { ...goal, createdAt: now, updatedAt: now };
+    this.goals.push(full);
+    return full;
+  }
+
+  updateStatus(id: string, status: Goal['status']): Goal {
+    const goal = this.getById(id);
+    if (!goal) throw new Error(`Goal not found: ${id}`);
+    goal.status = status;
+    goal.updatedAt = Date.now();
+    return goal;
+  }
+
+  list(): Goal[] {
+    return [...this.goals];
+  }
+
+  /** Test helper — seed a goal directly */
+  seed(goal: Goal): void {
+    this.goals.push(goal);
+  }
+}
+
+describe('GoalAncestry', () => {
+  let repo: InMemoryGoalRepository;
+  let ancestry: GoalAncestry;
+
+  beforeEach(() => {
+    repo = new InMemoryGoalRepository();
+    ancestry = new GoalAncestry(repo);
+  });
+
+  describe('getAncestors', () => {
+    it('should return empty array for goal with no parent', () => {
+      repo.seed({
+        id: 'g1',
+        title: 'Root',
+        level: 'objective',
+        status: 'active',
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      });
+
+      const ancestors = ancestry.getAncestors('g1');
+      expect(ancestors).toEqual([]);
+    });
+
+    it('should return one ancestor for 1-level depth', () => {
+      repo.seed({
+        id: 'root',
+        title: 'Root Objective',
+        level: 'objective',
+        status: 'active',
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      });
+      repo.seed({
+        id: 'child',
+        title: 'Project A',
+        level: 'project',
+        parentId: 'root',
+        status: 'active',
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+      });
+
+      const ancestors = ancestry.getAncestors('child');
+      expect(ancestors).toHaveLength(1);
+      expect(ancestors[0].id).toBe('root');
+    });
+
+    it('should walk 3 levels of ancestry', () => {
+      repo.seed({
+        id: 'obj',
+        title: 'Objective',
+        level: 'objective',
+        status: 'active',
+        createdAt: 1,
+        updatedAt: 1,
+      });
+      repo.seed({
+        id: 'proj',
+        title: 'Project',
+        level: 'project',
+        parentId: 'obj',
+        status: 'active',
+        createdAt: 2,
+        updatedAt: 2,
+      });
+      repo.seed({
+        id: 'plan',
+        title: 'Plan',
+        level: 'plan',
+        parentId: 'proj',
+        status: 'active',
+        createdAt: 3,
+        updatedAt: 3,
+      });
+      repo.seed({
+        id: 'task',
+        title: 'Task',
+        level: 'task',
+        parentId: 'plan',
+        status: 'planned',
+        createdAt: 4,
+        updatedAt: 4,
+      });
+
+      const ancestors = ancestry.getAncestors('task');
+      expect(ancestors).toHaveLength(3);
+      // Closest first: plan, proj, obj
+      expect(ancestors[0].id).toBe('plan');
+      expect(ancestors[1].id).toBe('proj');
+      expect(ancestors[2].id).toBe('obj');
+    });
+
+    it('should stop at max 10 levels', () => {
+      // Build a chain of 12 goals
+      for (let i = 0; i < 12; i++) {
+        repo.seed({
+          id: `g${i}`,
+          title: `Goal ${i}`,
+          level: 'project',
+          parentId: i > 0 ? `g${i - 1}` : undefined,
+          status: 'active',
+          createdAt: i,
+          updatedAt: i,
+        });
+      }
+
+      const ancestors = ancestry.getAncestors('g11');
+      expect(ancestors.length).toBeLessThanOrEqual(10);
+    });
+
+    it('should throw on cycle detection', () => {
+      repo.seed({
+        id: 'a',
+        title: 'A',
+        level: 'project',
+        parentId: 'b',
+        status: 'active',
+        createdAt: 1,
+        updatedAt: 1,
+      });
+      repo.seed({
+        id: 'b',
+        title: 'B',
+        level: 'project',
+        parentId: 'a',
+        status: 'active',
+        createdAt: 2,
+        updatedAt: 2,
+      });
+
+      expect(() => ancestry.getAncestors('a')).toThrow(/[Cc]ycle/);
+    });
+
+    it('should return empty for nonexistent goal', () => {
+      const ancestors = ancestry.getAncestors('nonexistent');
+      expect(ancestors).toEqual([]);
+    });
+  });
+
+  describe('getContext', () => {
+    it('should render markdown hierarchy from root to current', () => {
+      repo.seed({
+        id: 'obj',
+        title: 'Ship v2',
+        level: 'objective',
+        status: 'active',
+        createdAt: 1,
+        updatedAt: 1,
+      });
+      repo.seed({
+        id: 'proj',
+        title: 'Auth System',
+        level: 'project',
+        parentId: 'obj',
+        status: 'active',
+        createdAt: 2,
+        updatedAt: 2,
+      });
+      repo.seed({
+        id: 'plan',
+        title: 'JWT Implementation',
+        level: 'plan',
+        parentId: 'proj',
+        status: 'active',
+        createdAt: 3,
+        updatedAt: 3,
+      });
+
+      const md = ancestry.getContext('plan');
+      expect(md).toContain('## Goal Context');
+      expect(md).toContain('[objective] Ship v2');
+      expect(md).toContain('[project] Auth System');
+      expect(md).toContain('[plan] JWT Implementation');
+    });
+
+    it('should return empty string for nonexistent goal', () => {
+      expect(ancestry.getContext('nope')).toBe('');
+    });
+
+    it('should mark current goal with bold arrow', () => {
+      repo.seed({
+        id: 'obj',
+        title: 'Objective',
+        level: 'objective',
+        status: 'active',
+        createdAt: 1,
+        updatedAt: 1,
+      });
+      const md = ancestry.getContext('obj');
+      expect(md).toContain('**→**');
+    });
+  });
+
+  describe('inject', () => {
+    it('should add goalAncestry to config', () => {
+      repo.seed({
+        id: 'obj',
+        title: 'Ship v2',
+        level: 'objective',
+        status: 'active',
+        createdAt: 1,
+        updatedAt: 1,
+      });
+      repo.seed({
+        id: 'task',
+        title: 'Do thing',
+        level: 'task',
+        parentId: 'obj',
+        status: 'planned',
+        createdAt: 2,
+        updatedAt: 2,
+      });
+
+      const ctx = { config: { timeout: 5000 } };
+      const enriched = ancestry.inject(ctx, 'task');
+      expect(enriched.config?.goalAncestry).toContain('## Goal Context');
+      expect(enriched.config?.timeout).toBe(5000);
+    });
+
+    it('should return original context if goal not found', () => {
+      const ctx = { config: { foo: 'bar' } };
+      const result = ancestry.inject(ctx, 'nonexistent');
+      expect(result).toEqual(ctx);
+    });
+  });
+});
+
+describe('JsonGoalRepository', () => {
+  let tempDir: string;
+  let repo: JsonGoalRepository;
+
+  beforeEach(() => {
+    tempDir = join(tmpdir(), `goal-repo-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+    repo = new JsonGoalRepository(join(tempDir, 'goals.json'));
+  });
+
+  afterEach(() => {
+    rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('should create and retrieve a goal', () => {
+    const goal = repo.create({ id: 'g1', title: 'Ship it', level: 'objective', status: 'planned' });
+    expect(goal.createdAt).toBeGreaterThan(0);
+    expect(repo.getById('g1')?.title).toBe('Ship it');
+  });
+
+  it('should list goals by parent', () => {
+    repo.create({ id: 'parent', title: 'Parent', level: 'objective', status: 'active' });
+    repo.create({
+      id: 'child1',
+      title: 'Child 1',
+      level: 'project',
+      parentId: 'parent',
+      status: 'planned',
+    });
+    repo.create({
+      id: 'child2',
+      title: 'Child 2',
+      level: 'project',
+      parentId: 'parent',
+      status: 'planned',
+    });
+
+    const children = repo.getByParentId('parent');
+    expect(children).toHaveLength(2);
+  });
+
+  it('should update status', () => {
+    repo.create({ id: 'g1', title: 'Goal', level: 'plan', status: 'planned' });
+    const updated = repo.updateStatus('g1', 'completed');
+    expect(updated.status).toBe('completed');
+    expect(repo.getById('g1')?.status).toBe('completed');
+  });
+
+  it('should throw when updating nonexistent goal', () => {
+    expect(() => repo.updateStatus('nope', 'active')).toThrow(/not found/);
+  });
+
+  it('should persist across instances', () => {
+    const filePath = join(tempDir, 'goals.json');
+    const repo1 = new JsonGoalRepository(filePath);
+    repo1.create({ id: 'g1', title: 'Persisted', level: 'objective', status: 'active' });
+
+    const repo2 = new JsonGoalRepository(filePath);
+    expect(repo2.getById('g1')?.title).toBe('Persisted');
+  });
+});
+
+describe('generateGoalId', () => {
+  it('should include the level in the ID', () => {
+    expect(generateGoalId('objective')).toMatch(/^goal-objective-/);
+    expect(generateGoalId('task')).toMatch(/^goal-task-/);
+  });
+});
+
+describe('Planner goalId integration', () => {
+  let tempDir: string;
+  let planner: Planner;
+
+  beforeEach(() => {
+    tempDir = join(tmpdir(), `planner-goal-test-${Date.now()}`);
+    mkdirSync(tempDir, { recursive: true });
+    planner = new Planner(join(tempDir, 'plans.json'));
+  });
+
+  afterEach(() => {
+    rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('should store goalId on created plan', () => {
+    const plan = planner.create({
+      objective: 'Add auth',
+      scope: 'backend',
+      goalId: 'goal-plan-123',
+    });
+    expect(plan.goalId).toBe('goal-plan-123');
+  });
+
+  it('should create plan without goalId (backward compat)', () => {
+    const plan = planner.create({ objective: 'Add auth', scope: 'backend' });
+    expect(plan.goalId).toBeUndefined();
+  });
+
+  it('should preserve goalId through split', () => {
+    const plan = planner.create({
+      objective: 'Add auth',
+      scope: 'backend',
+      goalId: 'goal-plan-456',
+    });
+
+    planner.splitTasks(plan.id, [
+      { title: 'JWT', description: 'Implement JWT' },
+      { title: 'Middleware', description: 'Auth middleware' },
+    ]);
+
+    const updated = planner.get(plan.id)!;
+    expect(updated.goalId).toBe('goal-plan-456');
+    expect(updated.tasks).toHaveLength(2);
+  });
+});
+
+describe('formatIssueBody with goal context', () => {
+  it('should include goal context section when provided', () => {
+    const body = formatIssueBody(
+      {
+        planId: 'plan-1',
+        grade: 'A',
+        score: 92,
+        objective: 'Build auth',
+        decisions: [],
+        tasks: [{ id: 'task-1', title: 'JWT', description: 'Implement JWT' }],
+      },
+      'JWT',
+      'Implement JWT tokens',
+      { goalContext: '## Goal Context\n\n- [objective] Ship v2 (active)' },
+    );
+
+    expect(body).toContain('## Goal Context');
+    expect(body).toContain('[objective] Ship v2');
+  });
+
+  it('should not include section when no goal context', () => {
+    const body = formatIssueBody(
+      {
+        planId: 'plan-1',
+        grade: 'A',
+        score: 92,
+        objective: 'Build auth',
+        decisions: [],
+        tasks: [],
+      },
+      'JWT',
+      'Implement JWT tokens',
+    );
+
+    expect(body).not.toContain('## Goal Context');
+  });
+});