@compilr-dev/sdk 0.11.0 → 0.12.0

package/dist/index.d.ts

@@ -64,8 +64,8 @@ export { detectProject, suggestProjectType, detectCommon } from './detection/ind
 export type { DetectProjectOptions, DetectionResult, ContentSummary } from './detection/index.js';
 export { createGuideTool, SHARED_GUIDE_ENTRIES, searchGuideEntries, topicToGuideEntry, } from './guide/index.js';
 export type { GuideEntry, ContentTopic, ContentSection, GuideToolConfig } from './guide/index.js';
-export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createImageTools, ProjectAnchorStore, } from './platform/index.js';
-export type { ProjectAnchorStoreConfig, ImageToolsConfig, ImageResizer } from './platform/index.js';
+export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
+export type { ProjectAnchorStoreConfig, FileArtifactServiceConfig, ImageToolsConfig, ImageResizer, } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
 export type { CustomSkill, CompilrSkillExtension, ForkedFromMarker, SkillEligibilityContext, SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './skills/index.js';
 export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readSkillScopeConfig, readSkillScopeConfigSync, writeSkillScopeConfig, getSkillBindings, resolveSkillBinding, } from './skills/index.js';

package/dist/index.js

@@ -147,7 +147,7 @@ export { createGuideTool, SHARED_GUIDE_ENTRIES, searchGuideEntries, topicToGuide
 // =============================================================================
 // Platform Tools (runtime — createPlatformTools factory + individual factories)
 // =============================================================================
-export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createImageTools, ProjectAnchorStore, } from './platform/index.js';
+export { createPlatformTools, createProjectTools, createWorkItemTools, createDocumentTools, createPlanTools, createBacklogTools, createAnchorTools, createArtifactTools, createEpisodeTools, createImageTools, ProjectAnchorStore, FileArtifactService, } from './platform/index.js';
 // =============================================================================
 // Platform Workflow (pure step-criteria logic)
 // =============================================================================

package/dist/platform/file-artifact-service.d.ts

@@ -0,0 +1,55 @@
+/**
+ * FileArtifactService — file-backed IArtifactService shared by CLI and Desktop.
+ *
+ * Both hosts previously hand-rolled identical artifact CRUD on top of the SDK's
+ * ArtifactStore, reading/writing the SAME file:
+ *   {sessionsDir}/{global | project-<id>}/artifacts/artifacts.json
+ * This consolidates that logic next to FileEpisodeStore / ProjectAnchorStore.
+ *
+ * Each operation does a fresh load → mutate → save (the file is the source of
+ * truth, shared per-project across terminals), matching the prior behavior.
+ *
+ * Hosts wire in:
+ *  - getProjectId: resolved per call, so the service follows project switches
+ *  - onSaved (optional): fired after a create/update persists — the CLI uses it
+ *    to record team activity; Desktop omits it
+ *  - onError (optional): load/save failures, so each host logs as it sees fit
+ */
+import type { IArtifactService, ArtifactData, ArtifactSummaryData, ArtifactType } from './services.js';
+export interface FileArtifactServiceConfig {
+    /** Sessions root, e.g. ~/.compilr-dev/sessions */
+    sessionsDir: string;
+    /** Active project id (null = global), resolved on every call. */
+    getProjectId: () => number | null;
+    /** Fired after a successful create/update persists. */
+    onSaved?: (artifact: ArtifactData, isUpdate: boolean) => void;
+    /** Fired on a load/save failure (host decides how to log). */
+    onError?: (err: unknown, op: 'load' | 'save') => void;
+}
+export declare class FileArtifactService implements IArtifactService {
+    private readonly config;
+    constructor(config: FileArtifactServiceConfig);
+    private artifactsDir;
+    private dataFile;
+    /** Load the artifact store for a project from disk (empty store if absent). */
+    private loadStore;
+    /** Persist the artifact store for a project to disk. */
+    private saveStore;
+    save(input: {
+        name: string;
+        type: ArtifactType;
+        content: string;
+        summary?: string;
+        agent?: string;
+    }): Promise<{
+        artifact: ArtifactData;
+        isUpdate: boolean;
+    }>;
+    getByName(name: string): Promise<ArtifactData | null>;
+    list(options?: {
+        type?: ArtifactType;
+        agent?: string;
+        search?: string;
+    }): Promise<ArtifactSummaryData[]>;
+    delete(name: string): Promise<ArtifactData | null>;
+}

package/dist/platform/file-artifact-service.js

@@ -0,0 +1,140 @@
+/**
+ * FileArtifactService — file-backed IArtifactService shared by CLI and Desktop.
+ *
+ * Both hosts previously hand-rolled identical artifact CRUD on top of the SDK's
+ * ArtifactStore, reading/writing the SAME file:
+ *   {sessionsDir}/{global | project-<id>}/artifacts/artifacts.json
+ * This consolidates that logic next to FileEpisodeStore / ProjectAnchorStore.
+ *
+ * Each operation does a fresh load → mutate → save (the file is the source of
+ * truth, shared per-project across terminals), matching the prior behavior.
+ *
+ * Hosts wire in:
+ *  - getProjectId: resolved per call, so the service follows project switches
+ *  - onSaved (optional): fired after a create/update persists — the CLI uses it
+ *    to record team activity; Desktop omits it
+ *  - onError (optional): load/save failures, so each host logs as it sees fit
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { ArtifactStore } from '../team/artifacts.js';
+function toArtifactData(a) {
+    return {
+        id: a.id,
+        name: a.name,
+        agent: a.agent,
+        type: a.type,
+        content: a.content,
+        summary: a.summary,
+        version: a.version,
+        createdAt: a.createdAt,
+        updatedAt: a.updatedAt,
+    };
+}
+export class FileArtifactService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    artifactsDir(projectId) {
+        const projectDir = projectId === null
+            ? join(this.config.sessionsDir, 'global')
+            : join(this.config.sessionsDir, `project-${String(projectId)}`);
+        return join(projectDir, 'artifacts');
+    }
+    dataFile(projectId) {
+        return join(this.artifactsDir(projectId), 'artifacts.json');
+    }
+    /** Load the artifact store for a project from disk (empty store if absent). */
+    loadStore(projectId) {
+        const store = new ArtifactStore();
+        const file = this.dataFile(projectId);
+        if (!existsSync(file))
+            return store;
+        try {
+            const data = JSON.parse(readFileSync(file, 'utf-8'));
+            store.restore(data);
+        }
+        catch (err) {
+            // Corrupt/unreadable — start fresh rather than crash the tool call.
+            this.config.onError?.(err, 'load');
+        }
+        return store;
+    }
+    /** Persist the artifact store for a project to disk. */
+    saveStore(projectId, store) {
+        const dir = this.artifactsDir(projectId);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        try {
+            writeFileSync(this.dataFile(projectId), JSON.stringify(store.serialize(), null, 2), 'utf-8');
+        }
+        catch (err) {
+            this.config.onError?.(err, 'save');
+        }
+    }
+    save(input) {
+        const projectId = this.config.getProjectId();
+        const store = this.loadStore(projectId);
+        const agentId = input.agent ?? 'default';
+        const existing = store.getByName(input.name);
+        if (existing) {
+            const updated = store.update(existing.id, {
+                content: input.content,
+                summary: input.summary,
+                type: input.type,
+            });
+            if (!updated)
+                throw new Error(`Failed to update artifact "${input.name}"`);
+            this.saveStore(projectId, store);
+            const artifact = toArtifactData(updated);
+            this.config.onSaved?.(artifact, true);
+            return Promise.resolve({ artifact, isUpdate: true });
+        }
+        const created = store.create({
+            name: input.name,
+            agent: agentId,
+            type: input.type,
+            content: input.content,
+            summary: input.summary,
+        });
+        this.saveStore(projectId, store);
+        const artifact = toArtifactData(created);
+        this.config.onSaved?.(artifact, false);
+        return Promise.resolve({ artifact, isUpdate: false });
+    }
+    getByName(name) {
+        const store = this.loadStore(this.config.getProjectId());
+        const a = store.getByName(name);
+        return Promise.resolve(a ? toArtifactData(a) : null);
+    }
+    list(options) {
+        const store = this.loadStore(this.config.getProjectId());
+        let items = options?.search ? store.search(options.search) : store.list();
+        if (options?.type)
+            items = items.filter((a) => a.type === options.type);
+        if (options?.agent)
+            items = items.filter((a) => a.agent === options.agent);
+        const summaries = items.map((a) => ({
+            id: a.id,
+            name: a.name,
+            agent: a.agent,
+            type: a.type,
+            summary: a.summary,
+            version: a.version,
+            updatedAt: a.updatedAt,
+        }));
+        return Promise.resolve(summaries);
+    }
+    delete(name) {
+        const projectId = this.config.getProjectId();
+        const store = this.loadStore(projectId);
+        const a = store.getByName(name);
+        if (!a)
+            return Promise.resolve(null);
+        if (!store.delete(a.id))
+            return Promise.resolve(null);
+        this.saveStore(projectId, store);
+        return Promise.resolve(toArtifactData(a));
+    }
+}

package/dist/platform/index.d.ts

@@ -11,5 +11,7 @@ export { createSQLiteRepositories, SQLiteProjectRepository, SQLiteWorkItemReposi
 export type { SQLiteRepositories, CreateSQLiteRepositoriesOptions, ProjectDeleteHooks, ProjectRecord, WorkItemRecord, ProjectDocumentRecord, WorkItemCommentRecord, } from './sqlite/index.js';
 export { ProjectAnchorStore } from './file-anchor-service.js';
 export type { ProjectAnchorStoreConfig } from './file-anchor-service.js';
+export { FileArtifactService } from './file-artifact-service.js';
+export type { FileArtifactServiceConfig } from './file-artifact-service.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './workflow.js';
 export type { StepCriteria } from './workflow.js';

package/dist/platform/index.js

@@ -7,5 +7,7 @@ export { createPlatformTools, createProjectTools, createWorkItemTools, createDoc
 export { createSQLiteRepositories, SQLiteProjectRepository, SQLiteWorkItemRepository, SQLiteDocumentRepository, SQLitePlanRepository, SQLiteCommentRepository, getDatabase, closeDatabase, closeAllDatabases, databaseExists, SCHEMA_VERSION, SCHEMA_SQL, } from './sqlite/index.js';
 // File-based anchor service (shared by CLI and Desktop)
 export { ProjectAnchorStore } from './file-anchor-service.js';
+// File-based artifact service (shared by CLI and Desktop)
+export { FileArtifactService } from './file-artifact-service.js';
 // Workflow (pure step-criteria logic)
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './workflow.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",