@vpxa/aikit 0.1.50 → 0.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/aikit",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",

package/packages/flows/dist/adapters/index.d.ts

@@ -2,10 +2,11 @@ import { FlowFormat, FlowFormatAdapter } from "../types.js";
 import { ClaudePluginAdapter } from "./claude-plugin.js";
 import { CopilotAdapter } from "./copilot.js";
 import { NativeAdapter } from "./native.js";
+import { OpenSpecAdapter } from "./openspec.js";
 
 //#region packages/flows/src/adapters/index.d.ts
 declare function detectFormat(sourceDir: string): FlowFormat | null;
 declare function getAdapter(format: FlowFormat): FlowFormatAdapter;
 declare function getAdapterForSource(sourceDir: string): FlowFormatAdapter | null;
 //#endregion
-export { ClaudePluginAdapter, CopilotAdapter, NativeAdapter, detectFormat, getAdapter, getAdapterForSource };
+export { ClaudePluginAdapter, CopilotAdapter, NativeAdapter, OpenSpecAdapter, detectFormat, getAdapter, getAdapterForSource };

package/packages/flows/dist/adapters/index.js

@@ -1 +1 @@
-import{ClaudePluginAdapter as e}from"./claude-plugin.js";import{CopilotAdapter as t}from"./copilot.js";import{NativeAdapter as n}from"./native.js";const r=[new n,new e,new t];function i(e){for(let t of r)if(t.detect(e))return t.format;return null}function a(e){let t=r.find(t=>t.format===e);if(!t)throw Error(`No adapter for format: ${e}`);return t}function o(e){for(let t of r)if(t.detect(e))return t;return null}export{e as ClaudePluginAdapter,t as CopilotAdapter,n as NativeAdapter,i as detectFormat,a as getAdapter,o as getAdapterForSource};
+import{ClaudePluginAdapter as e}from"./claude-plugin.js";import{CopilotAdapter as t}from"./copilot.js";import{NativeAdapter as n}from"./native.js";import{OpenSpecAdapter as r}from"./openspec.js";const i=[new n,new e,new t,new r];function a(e){for(let t of i)if(t.detect(e))return t.format;return null}function o(e){let t=i.find(t=>t.format===e);if(!t)throw Error(`No adapter for format: ${e}`);return t}function s(e){for(let t of i)if(t.detect(e))return t;return null}export{e as ClaudePluginAdapter,t as CopilotAdapter,n as NativeAdapter,r as OpenSpecAdapter,a as detectFormat,o as getAdapter,s as getAdapterForSource};

package/packages/flows/dist/adapters/openspec.d.ts

@@ -0,0 +1,25 @@
+import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
+
+//#region packages/flows/src/adapters/openspec.d.ts
+declare class OpenSpecAdapter implements FlowFormatAdapter {
+  readonly format: "openspec";
+  detect(sourceDir: string): boolean;
+  parse(sourceDir: string, _options?: FlowParseOptions): Promise<FlowManifest>;
+  /**
+   * Read metadata from package.json if available, otherwise use defaults
+   * derived from the openspec config.
+   */
+  private readMeta;
+  /**
+   * Discover phases from the openspec/specs/ directory.
+   * If the directory contains subdirectories matching known phases, use those.
+   * Otherwise, fall back to the full standard phase list.
+   */
+  private discoverPhases;
+  /**
+   * Convert phases to FlowSteps with linear dependency chain.
+   */
+  private buildSteps;
+}
+//#endregion
+export { OpenSpecAdapter };

package/packages/flows/dist/adapters/openspec.js

@@ -0,0 +1 @@
+import{existsSync as e,readFileSync as t,readdirSync as n,statSync as r}from"node:fs";import{basename as i,join as a}from"node:path";const o=[{id:`propose`,name:`Propose`,description:`Create a change proposal outlining the problem, motivation, and high-level approach`,produces:[`proposal.md`]},{id:`specs`,name:`Specs`,description:`Write detailed specifications with acceptance criteria and constraints`,produces:[`specs/`]},{id:`design`,name:`Design`,description:`Produce a technical design document mapping specs to implementation approach`,produces:[`design.md`]},{id:`tasks`,name:`Tasks`,description:`Break the design into ordered, actionable implementation tasks`,produces:[`tasks.md`]},{id:`apply`,name:`Apply`,description:`Implement the tasks, writing code and tests according to the design`,produces:[]},{id:`archive`,name:`Archive`,description:`Archive the completed change and update project documentation`,produces:[]}];var s=class{format=`openspec`;detect(t){return e(a(t,`openspec`,`config.yaml`))}async parse(e,t){let n=this.readMeta(e),r=a(e,`openspec`,`specs`),i=this.discoverPhases(r),o=this.buildSteps(i);return{name:n.name,version:n.version,description:n.description,author:n.author,steps:o,agents:[],artifacts_dir:`openspec`,install:[]}}readMeta(n){let r=a(n,`package.json`);if(e(r))try{let e=JSON.parse(t(r,`utf-8`));return{name:e.name??i(n),version:e.version??`0.1.0`,description:e.description??`OpenSpec flow`,author:e.author}}catch{}return{name:i(n),version:`0.1.0`,description:`OpenSpec flow`}}discoverPhases(t){if(!e(t))return o;try{let e=n(t).filter(e=>r(a(t,e)).isDirectory());if(e.length===0)return o;let i=new Set(o.map(e=>e.id)),s=e.filter(e=>i.has(e));if(s.length>0)return o.filter(e=>s.includes(e.id))}catch{}return o}buildSteps(e){return e.map((t,n)=>({id:t.id,name:t.name,instruction:`steps/${t.id}/README.md`,produces:t.produces,requires:n>0?[e[n-1].id]:[],agents:[],description:t.description}))}};export{s as OpenSpecAdapter};

package/packages/flows/dist/types.d.ts

@@ -41,7 +41,7 @@ interface FlowManifest {
 /** Source type for flow installation */
 type FlowSourceType = 'builtin' | 'git' | 'local';
 /** Detected format of the flow source */
-type FlowFormat = 'native' | 'claude-plugin' | 'copilot';
+type FlowFormat = 'native' | 'claude-plugin' | 'copilot' | 'openspec';
 /** Registry entry for an installed flow */
 interface FlowRegistryEntry {
   /** Flow name */