@compilr-dev/sdk 0.29.4 → 0.29.6

package/dist/actions/index.d.ts

@@ -25,5 +25,4 @@
  * ```
  */
 export type { ActionContext, ActionDefinition } from './types.js';
-export { ACTION_REGISTRY, getActionsForContext, getActionById } from './registry.js';
-export { resolveActionPrompt, buildContextSummary, getSuggestedRole } from './resolver.js';
+export { resolveActionPrompt, buildContextSummary } from './resolver.js';

package/dist/actions/index.js

@@ -25,6 +25,14 @@
  * ```
  */
 // Registry
-export { ACTION_REGISTRY, getActionsForContext, getActionById } from './registry.js';
+/*
+  ⚠️ ACTION_REGISTRY IS GONE — superseded, not merely unused. `MACRO_META_REGISTRY` replaced it
+  during the macro rename and is a strict superset (55 entries against 14, every id present). The
+  old one kept an IPC handler and a preload binding alive that nothing called, which made it look
+  like the action source and cost a wrong assumption in the Projects plan.
+
+  `resolveActionPrompt` never read it: it resolves by skill NAME from the array it is given, so
+  the live path was never coupled to the dead one.
+*/
 // Resolver
-export { resolveActionPrompt, buildContextSummary, getSuggestedRole } from './resolver.js';
+export { resolveActionPrompt, buildContextSummary } from './resolver.js';

package/dist/actions/resolver.d.ts

@@ -23,7 +23,3 @@ export declare function resolveActionPrompt(actionId: string, context: ActionCon
  * Used by the ActionCard component to show a brief description.
  */
 export declare function buildContextSummary(context: ActionContext): string;
-/**
- * Get the suggested agent role for an action.
- */
-export declare function getSuggestedRole(actionId: string): string | undefined;

package/dist/actions/resolver.js

@@ -7,7 +7,6 @@
  *
  * Used by both CLI and desktop to turn user actions into agent prompts.
  */
-import { getActionById } from './registry.js';
 /**
  * Resolve an action + context into a final prompt for the agent.
  *
@@ -99,9 +98,3 @@ export function buildContextSummary(context) {
     }
     return '';
 }
-/**
- * Get the suggested agent role for an action.
- */
-export function getSuggestedRole(actionId) {
-    return getActionById(actionId)?.suggestedRole;
-}

package/dist/index.d.ts

@@ -87,7 +87,7 @@ export type { MacroListEntry, BuildMacroListOptions } from './skills/index.js';
 export { generateSkillCatalog, toCatalogEntry, createLoadSkillTool } from './skills/index.js';
 export type { SkillCatalogEntry, SkillSource } from './skills/index.js';
 export { platformMacros, designMacro, sketchMacro, prdMacro, refineMacro, refineItemMacro, architectureMacro, sessionNotesMacro, buildMacro, scaffoldMacro, outlineMacro, literatureReviewMacro, draftSectionMacro, peerReviewMacro, researchScaffoldMacro, businessVisionMacro, marketAnalysisMacro, competitorAnalysisMacro, financialModelMacro, pitchOutlineMacro, businessReviewMacro, brandSetupMacro, contentStrategyMacro, contentCalendarMacro, createContentMacro, contentReviewMacro, curriculumDesignMacro, lessonPlanMacro, assessmentDesignMacro, courseReviewMacro, bookOutlineMacro, characterDesignMacro, plotThreadsMacro, sceneBreakdownMacro, bookReviewMacro, } from './skills/index.js';
-export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
+export { resolveActionPrompt, buildContextSummary } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';
 export { PROJECT_TYPES, getProjectTypeConfig, getEnrichedProjectTypeConfig, getProjectTypesByCategory, generalConfig, softwareConfig, researchConfig, businessPlanConfig, contentConfig, techDocsConfig, courseConfig, MACRO_META_REGISTRY, resolveActionMeta, getRelevantMacros, getMacroMeta, getAllMacroMeta, } from './project-types/index.js';
 export type { ActionMeta, MacroMeta, MacroCategory, MacroCapabilities, } from './project-types/index.js';
@@ -110,6 +110,8 @@ export type { FileEpisodeStoreOptions, EpisodeRecorderConfig, WorkSummaryAnchorC
 export { resolveNext, evaluateBranchCondition, walkPastBranches, lookupLabel, applyBacktrack, } from './flow-runner/index.js';
 export type { BacktrackResult } from './flow-runner/index.js';
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, readMCPConfig, assertWritable, canConnect, } from './mcp-config.js';
+export { buildProjectUpdate } from './platform/project-patch.js';
+export type { ProjectPatch, ProjectUpdateResult } from './platform/project-patch.js';
 export type { MCPServerEntry, MCPConfigFile, ResolvedMCPServer, MCPConfigRead, ConfigValue, } from './mcp-config.js';
 export { serverHealth, needsAttention, describeHealth, estimateToolTokens, estimateServerCost, formatTokens, disabledTools, isToolEnabled, setToolEnabled, filterMcpToolsByEnablement, isSecretRef, secretRefFor, parseSecretRef, looksLikeSecret, resolveValues, describeMissing, planSecretStorage, toStoredValues, secretRefsOf, } from './mcp/index.js';
 export type { MCPServerHealth, MCPServerState, MCPConnectionStatus, HealthInput, MCPToolShape, ServerCost, SecretRef, ResolveResult, } from './mcp/index.js';

package/dist/index.js

@@ -166,7 +166,7 @@ export { platformMacros, designMacro, sketchMacro, prdMacro, refineMacro, refine
 // =============================================================================
 // Contextual Actions (skill invocations with context)
 // =============================================================================
-export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
+export { resolveActionPrompt, buildContextSummary } from './actions/index.js';
 // =============================================================================
 // Project Types
 // =============================================================================
@@ -233,6 +233,8 @@ export { resolveNext, evaluateBranchCondition, walkPastBranches, lookupLabel, ap
 // Shared MCP Configuration
 // =============================================================================
 export { readMCPConfigFile, writeMCPConfigFile, resolveServerEntry, loadMCPServers, saveMCPServerEntry, deleteMCPServerEntry, getServerNames, readMCPConfig, assertWritable, canConnect, } from './mcp-config.js';
+// Projects — the one allow-list both hosts write through (projects-restyling Phase 5)
+export { buildProjectUpdate } from './platform/project-patch.js';
 // MCP — health, per-tool enablement, secrets, cost (mcp-restyling Phase 1)
 export { serverHealth, needsAttention, describeHealth, estimateToolTokens, estimateServerCost, formatTokens, disabledTools, isToolEnabled, setToolEnabled, filterMcpToolsByEnablement, isSecretRef, secretRefFor, parseSecretRef, looksLikeSecret, resolveValues, describeMissing, planSecretStorage, toStoredValues, secretRefsOf, } from './mcp/index.js';
 // =============================================================================

package/dist/platform/project-patch.d.ts

@@ -0,0 +1,52 @@
+/**
+ * What a person may change about a project, and how it maps to the repository.
+ *
+ * ⚠️ ONE ALLOW-LIST, IN THE SDK, BECAUSE BOTH HOSTS WRITE PROJECTS. Desktop and the CLI each had
+ * their own hand-written snake_case mapping, and they had already drifted: the CLI turned an empty
+ * string into `undefined`, so a git remote could be set there but never CLEARED, while Desktop
+ * treated `''` as a deliberate clear. Same screen, same field, two different meanings for erasing
+ * it.
+ *
+ * ⚠️ AN ALLOW-LIST, NOT A SPREAD. `UpdateProjectInput` reaches machine state — `current_item_id`,
+ * `last_context`, `metadata` — and the SLUG via `name`. `projects.name` is UNIQUE NOT NULL and a
+ * real key, so an editor that could set it by sending one extra field could collide it or break
+ * every reference to it. The slug is derived at creation and frozen.
+ */
+import type { UpdateProjectInput } from './types.js';
+/** The camelCase fields an editor may write. Deliberately narrower than UpdateProjectInput. */
+export interface ProjectPatch {
+    displayName?: string;
+    description?: string;
+    /**
+     * Where the project lives.
+     *
+     * ⚠️ RE-POINTS THE PROJECT; IT DOES NOT MOVE ANYTHING. This is how a project whose folder was
+     * moved on disk is repaired — a host offering it should say so, because "Path" reads like a
+     * thing that relocates files.
+     */
+    path?: string;
+    docsPath?: string;
+    language?: string;
+    framework?: string;
+    packageManager?: string;
+    runtimeVersion?: string;
+    gitRemote?: string;
+    gitBranch?: string;
+    workflowMode?: string;
+    status?: string;
+}
+export type ProjectUpdateResult = {
+    ok: true;
+    input: UpdateProjectInput;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Map a patch onto the repository's input, or refuse it.
+ *
+ * ⚠️ AN EMPTY STRING IS A DELIBERATE CLEAR, NOT "LEAVE ALONE". Only `undefined` means untouched.
+ * Clearing a git remote has to be possible, and a host that cannot do it has no way to undo a
+ * typo in one.
+ */
+export declare function buildProjectUpdate(patch: ProjectPatch): ProjectUpdateResult;

package/dist/platform/project-patch.js

@@ -0,0 +1,69 @@
+/**
+ * What a person may change about a project, and how it maps to the repository.
+ *
+ * ⚠️ ONE ALLOW-LIST, IN THE SDK, BECAUSE BOTH HOSTS WRITE PROJECTS. Desktop and the CLI each had
+ * their own hand-written snake_case mapping, and they had already drifted: the CLI turned an empty
+ * string into `undefined`, so a git remote could be set there but never CLEARED, while Desktop
+ * treated `''` as a deliberate clear. Same screen, same field, two different meanings for erasing
+ * it.
+ *
+ * ⚠️ AN ALLOW-LIST, NOT A SPREAD. `UpdateProjectInput` reaches machine state — `current_item_id`,
+ * `last_context`, `metadata` — and the SLUG via `name`. `projects.name` is UNIQUE NOT NULL and a
+ * real key, so an editor that could set it by sending one extra field could collide it or break
+ * every reference to it. The slug is derived at creation and frozen.
+ */
+/*
+  ⚠️ `path` IS NOT IN HERE. `UpdateProjectInput` has no `path` key — it is written through the
+  repository's own column — so listing it beside the others would have needed a lie in the type.
+  It is handled explicitly in the loop, where the difference is visible.
+*/
+const FIELD_MAP = {
+    displayName: 'display_name',
+    description: 'description',
+    docsPath: 'docs_path',
+    language: 'language',
+    framework: 'framework',
+    packageManager: 'package_manager',
+    runtimeVersion: 'runtime_version',
+    gitRemote: 'git_remote',
+    gitBranch: 'git_branch',
+    workflowMode: 'workflow_mode',
+    status: 'status',
+};
+/**
+ * Map a patch onto the repository's input, or refuse it.
+ *
+ * ⚠️ AN EMPTY STRING IS A DELIBERATE CLEAR, NOT "LEAVE ALONE". Only `undefined` means untouched.
+ * Clearing a git remote has to be possible, and a host that cannot do it has no way to undo a
+ * typo in one.
+ */
+export function buildProjectUpdate(patch) {
+    const displayName = patch.displayName?.trim();
+    if (displayName !== undefined && displayName === '') {
+        return { ok: false, error: 'A project needs a name.' };
+    }
+    const path = patch.path?.trim();
+    if (path !== undefined && path === '') {
+        return {
+            ok: false,
+            error: 'A project needs a path — clearing it would lose track of the folder.',
+        };
+    }
+    const input = {};
+    if (path !== undefined)
+        input.path = path;
+    for (const key of Object.keys(FIELD_MAP)) {
+        const value = patch[key];
+        if (value === undefined)
+            continue;
+        if (key === 'displayName')
+            input.display_name = displayName;
+        else if (key === 'workflowMode')
+            input.workflow_mode = value;
+        else if (key === 'status')
+            input.status = value;
+        else
+            input[FIELD_MAP[key]] = value;
+    }
+    return { ok: true, input };
+}

package/package.json

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

package/dist/actions/registry.d.ts

@@ -1,17 +0,0 @@
-/**
- * Action Registry — Defines which actions are available and where.
- *
- * Each action maps to a skill (from platformMacros/builtinSkills)
- * but adds UI metadata: icon, label, category, applicable contexts,
- * and suggested agent role.
- */
-import type { ActionDefinition } from './types.js';
-export declare const ACTION_REGISTRY: ActionDefinition[];
-/**
- * Get actions applicable to a given context type.
- */
-export declare function getActionsForContext(contextType: 'project' | 'workitem' | 'document'): ActionDefinition[];
-/**
- * Get an action definition by ID.
- */
-export declare function getActionById(id: string): ActionDefinition | undefined;

package/dist/actions/registry.js

@@ -1,161 +0,0 @@
-/**
- * Action Registry — Defines which actions are available and where.
- *
- * Each action maps to a skill (from platformMacros/builtinSkills)
- * but adds UI metadata: icon, label, category, applicable contexts,
- * and suggested agent role.
- */
-export const ACTION_REGISTRY = [
-    // ─── Project-level actions ─────────────────────────────────────────────
-    {
-        id: 'design',
-        label: 'Design App',
-        description: 'Describe an idea, get a full application design',
-        icon: 'Wand2',
-        applicableTo: ['project'],
-        category: 'design',
-        // BA owns requirements: the 'ba' role (analyst profile) has both
-        // backlog_write and documents, so it can complete the full /design action
-        // (create work items + write the PRD). The architect profile lacks
-        // backlog_write and cannot create the backlog.
-        suggestedRole: 'ba',
-        needsInput: true,
-        inputPrompt: 'What would you like to design?',
-    },
-    {
-        id: 'sketch',
-        label: 'Quick Sketch',
-        description: 'Quickly sketch out an idea or concept',
-        icon: 'Pencil',
-        applicableTo: ['project'],
-        category: 'design',
-        needsInput: true,
-        inputPrompt: 'What would you like to sketch?',
-    },
-    {
-        id: 'prd',
-        label: 'Write PRD',
-        description: 'Create a product requirements document',
-        icon: 'FileText',
-        applicableTo: ['project'],
-        // PRD is artifact-authoring (requirements), grouped with design/architecture
-        // rather than backlog-breakdown 'planning' (refine/refine-item).
-        category: 'design',
-        // Requirements work → Business Analyst, not PM. The 'ba' role (analyst
-        // profile) is purpose-built for requirements gathering and has the
-        // documents tools needed to author the PRD.
-        suggestedRole: 'ba',
-    },
-    {
-        id: 'architecture',
-        label: 'Architecture',
-        description: 'Design the system architecture',
-        icon: 'Network',
-        applicableTo: ['project'],
-        category: 'design',
-        suggestedRole: 'architect',
-    },
-    {
-        id: 'scaffold',
-        label: 'Scaffold',
-        description: 'Generate project code from the app model',
-        icon: 'Layers',
-        applicableTo: ['project'],
-        category: 'development',
-        suggestedRole: 'developer',
-    },
-    {
-        id: 'session-notes',
-        label: 'Session Notes',
-        description: 'Summarize what was accomplished in this session',
-        icon: 'StickyNote',
-        applicableTo: ['project'],
-        category: 'documentation',
-    },
-    // ─── Work item actions ─────────────────────────────────────────────────
-    {
-        id: 'refine',
-        label: 'Refine',
-        description: 'Break down into smaller tasks',
-        icon: 'RefreshCw',
-        applicableTo: ['project', 'workitem'],
-        category: 'planning',
-        suggestedRole: 'pm',
-    },
-    {
-        id: 'refine-item',
-        label: 'Refine Item',
-        description: 'Add detail and acceptance criteria to this item',
-        icon: 'RefreshCw',
-        applicableTo: ['workitem'],
-        category: 'planning',
-        suggestedRole: 'pm',
-    },
-    {
-        id: 'build',
-        label: 'Build',
-        description: 'Implement this work item',
-        icon: 'Hammer',
-        applicableTo: ['workitem'],
-        category: 'development',
-        suggestedRole: 'developer',
-    },
-    {
-        id: 'code-review',
-        label: 'Code Review',
-        description: 'Review code for quality and correctness',
-        icon: 'Search',
-        applicableTo: ['project', 'workitem'],
-        category: 'development',
-        suggestedRole: 'qa',
-    },
-    {
-        id: 'debug',
-        label: 'Debug',
-        description: 'Debug an issue or error',
-        icon: 'Bug',
-        applicableTo: ['project', 'workitem'],
-        category: 'development',
-        suggestedRole: 'developer',
-    },
-    // ─── Document actions ──────────────────────────────────────────────────
-    {
-        id: 'explain',
-        label: 'Explain',
-        description: 'Explain this code or document',
-        icon: 'BookOpen',
-        applicableTo: ['document', 'workitem'],
-        category: 'documentation',
-    },
-    // ─── Analysis actions ──────────────────────────────────────────────────
-    {
-        id: 'security-review',
-        label: 'Security Review',
-        description: 'Review for security vulnerabilities',
-        icon: 'Shield',
-        applicableTo: ['project'],
-        category: 'analysis',
-        suggestedRole: 'security',
-    },
-    {
-        id: 'refactor',
-        label: 'Refactor',
-        description: 'Improve code quality without changing behavior',
-        icon: 'Scissors',
-        applicableTo: ['project', 'workitem'],
-        category: 'development',
-        suggestedRole: 'developer',
-    },
-];
-/**
- * Get actions applicable to a given context type.
- */
-export function getActionsForContext(contextType) {
-    return ACTION_REGISTRY.filter((a) => a.applicableTo.includes(contextType));
-}
-/**
- * Get an action definition by ID.
- */
-export function getActionById(id) {
-    return ACTION_REGISTRY.find((a) => a.id === id);
-}