@vpxa/aikit 0.1.52 → 0.1.54
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +2 -1
- package/packages/dashboard/dist/assets/{index-L06q8M9R.js → index-Cdke3KDK.js} +3 -3
- package/packages/dashboard/dist/assets/{index-L06q8M9R.js.map → index-Cdke3KDK.js.map} +1 -1
- package/packages/dashboard/dist/index.html +1 -1
- package/packages/flows/dist/adapters/claude-plugin.d.ts +5 -0
- package/packages/flows/dist/adapters/claude-plugin.js +3 -1
- package/packages/flows/dist/adapters/copilot.d.ts +4 -2
- package/packages/flows/dist/adapters/copilot.js +1 -1
- package/packages/flows/dist/adapters/openspec.d.ts +26 -11
- package/packages/flows/dist/adapters/openspec.js +1 -1
- package/packages/flows/dist/git.d.ts +1 -1
- package/packages/flows/dist/git.js +2 -2
- package/packages/flows/dist/index.d.ts +3 -2
- package/packages/flows/dist/index.js +1 -1
- package/packages/flows/dist/types.d.ts +10 -7
- package/packages/present/dist/index.html +256 -256
- package/packages/server/dist/tools/flow.tools.js +16 -1
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
html, body, #root { width: 100%; height: 100%; overflow: hidden; }
|
|
10
10
|
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #0d1117; color: #c9d1d9; }
|
|
11
11
|
</style>
|
|
12
|
-
<script type="module" crossorigin src="/_dashboard/assets/index-
|
|
12
|
+
<script type="module" crossorigin src="/_dashboard/assets/index-Cdke3KDK.js"></script>
|
|
13
13
|
<link rel="stylesheet" crossorigin href="/_dashboard/assets/index-CHpVij2M.css">
|
|
14
14
|
</head>
|
|
15
15
|
<body>
|
|
@@ -5,7 +5,10 @@ declare class ClaudePluginAdapter implements FlowFormatAdapter {
|
|
|
5
5
|
readonly format: "claude-plugin";
|
|
6
6
|
detect(sourceDir: string): boolean;
|
|
7
7
|
parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
|
|
8
|
+
private readPluginJson;
|
|
9
|
+
private readString;
|
|
8
10
|
private discoverSteps;
|
|
11
|
+
private readStep;
|
|
9
12
|
/**
|
|
10
13
|
* Copy supporting subdirectories (references/, assets/, scripts/) from
|
|
11
14
|
* skills/<step>/ to steps/<step>/ so that relative paths inside the
|
|
@@ -14,6 +17,8 @@ declare class ClaudePluginAdapter implements FlowFormatAdapter {
|
|
|
14
17
|
* When `force` is true, existing copies are replaced (used during updates).
|
|
15
18
|
*/
|
|
16
19
|
private syncStepAssets;
|
|
20
|
+
private materializeNativeSteps;
|
|
21
|
+
private buildStepReadme;
|
|
17
22
|
private discoverAgents;
|
|
18
23
|
}
|
|
19
24
|
//#endregion
|
|
@@ -1 +1,3 @@
|
|
|
1
|
-
import{cpSync as e,existsSync as t,
|
|
1
|
+
import{cpSync as e,existsSync as t,mkdirSync as n,readFileSync as r,readdirSync as i,rmSync as a,writeFileSync as o}from"node:fs";import{basename as s,join as c}from"node:path";const l=[`spec`,`plan`,`task`,`execute`,`verify`];function u(e){let t=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!t)return{data:{},body:e};let n={};for(let e of t[1].split(/\r?\n/)){let t=e.indexOf(`:`);t>0&&(n[e.slice(0,t).trim()]=e.slice(t+1).trim().replace(/^["']|["']$/g,``))}return{data:n,body:t[2]}}function d(e){return e.split(/[-_]/g).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}function f(e){let t=l.indexOf(e);return t===-1?1/0:t}var p=class{format=`claude-plugin`;detect(e){return t(c(e,`.claude-plugin`,`plugin.json`))}async parse(e,t){let n=this.readPluginJson(e),r=this.discoverSteps(e);await this.materializeNativeSteps(e,r,t);let i=this.discoverAgents(e),a=r.map(({step:e})=>e);return{name:this.readString(n.name)??s(e),version:this.readString(n.version)??`1.0.0`,description:this.readString(n.description)??``,author:this.readString(n.author),steps:a,agents:i,artifacts_dir:`.spec`,install:[]}}readPluginJson(e){let t=c(e,`.claude-plugin`,`plugin.json`);return JSON.parse(r(t,`utf-8`))}readString(e){return typeof e==`string`?e:void 0}discoverSteps(e){let n=c(e,`skills`);if(!t(n))return[];let r=i(n,{withFileTypes:!0}).filter(e=>e.isDirectory()).map(e=>e.name).map(t=>this.readStep(e,t)).filter(e=>e!==null).sort((e,t)=>{let n=Number(e.metadata.order),r=Number(t.metadata.order),i=Number.isFinite(n),a=Number.isFinite(r);if(i&&a)return n-r;if(i)return-1;if(a)return 1;let o=f(e.step.id),s=f(t.step.id);return o===s?e.step.id.localeCompare(t.step.id):o-s});return r.map((e,t)=>({...e,step:{...e.step,requires:t>0?[r[t-1].step.id]:[]}}))}readStep(e,n){let i=c(e,`skills`,n,`SKILL.md`);if(!t(i))return null;let a=r(i,`utf-8`),{data:o,body:s}=u(a),l=o.name||d(n),f=o.description||`${l} step`;return{step:{id:n,name:l,instruction:`steps/${n}/README.md`,produces:[`${n}.md`],requires:[],agents:[],description:f},metadata:o,content:a,body:s}}syncStepAssets(n,r,i){let o=[`references`,`assets`,`scripts`];for(let s of r)for(let r of o){let o=c(n,`skills`,s.id,r),l=c(n,`steps`,s.id,r);if(t(o)){if(t(l)){if(!i)continue;a(l,{recursive:!0,force:!0})}e(o,l,{recursive:!0})}}}async materializeNativeSteps(e,t,r){for(let i of t){let t=c(e,`steps`,i.step.id);n(t,{recursive:!0});let a=r?.transform?await r.transform({content:i.content,sourceFormat:`claude-plugin`,stepName:i.step.id,metadata:i.metadata}):this.buildStepReadme(i.step.name,i.step.description,i.body);o(c(t,`README.md`),a,`utf-8`)}this.syncStepAssets(e,t.map(({step:e})=>e),r?.forceAssetSync)}buildStepReadme(e,t,n){return[`# ${e}`,``,t,``,`---`,``,n.trim()].join(`
|
|
2
|
+
`).trimEnd().concat(`
|
|
3
|
+
`)}discoverAgents(e){let n=c(e,`agents`);return t(n)?i(n,{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.md`)).map(e=>`agents/${e.name}`):[]}};export{p as ClaudePluginAdapter};
|
|
@@ -1,10 +1,12 @@
|
|
|
1
|
-
import { FlowFormatAdapter, FlowManifest } from "../types.js";
|
|
1
|
+
import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
|
|
2
2
|
|
|
3
3
|
//#region packages/flows/src/adapters/copilot.d.ts
|
|
4
4
|
declare class CopilotAdapter implements FlowFormatAdapter {
|
|
5
5
|
readonly format: "copilot";
|
|
6
6
|
detect(sourceDir: string): boolean;
|
|
7
|
-
parse(sourceDir: string): Promise<FlowManifest>;
|
|
7
|
+
parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
|
|
8
|
+
private getStepId;
|
|
9
|
+
private materializeSteps;
|
|
8
10
|
}
|
|
9
11
|
//#endregion
|
|
10
12
|
export { CopilotAdapter };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{existsSync as e,readdirSync as
|
|
1
|
+
import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,writeFileSync as i}from"node:fs";import{basename as a,join as o}from"node:path";var s=class{format=`copilot`;detect(t){return e(o(t,`.github`,`agents`))}async parse(e,t){let n=r(o(e,`.github`,`agents`),{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(`.md`)).map(e=>`.github/agents/${e.name}`),i=n.map(e=>this.getStepId(e)),s=n.map((e,t)=>{let n=i[t];return{id:n,name:n.charAt(0).toUpperCase()+n.slice(1),instruction:`steps/${n}/README.md`,produces:[`${n}.md`],requires:t>0?[i[t-1]]:[],agents:[e],description:`${n} agent step`}});return await this.materializeSteps(e,s,t),{name:a(e),version:`1.0.0`,description:`Copilot agents flow from ${a(e)}`,steps:s,agents:n,artifacts_dir:`.spec`,install:[]}}getStepId(e){return a(e,`.md`).toLowerCase().replace(/\.agent$/,``)}async materializeSteps(e,r,a){for(let s of r){let r=s.agents[0];if(!r)continue;let c=n(o(e,r),`utf-8`),l=o(e,`steps`,s.id),u=o(l,`README.md`);t(l,{recursive:!0}),i(u,a?.transform?await a.transform({content:c,sourceFormat:`copilot`,stepName:s.id,metadata:{sourcePath:r,displayName:s.name}}):`# ${s.name}\n\n${c}`,`utf-8`)}}};export{s as CopilotAdapter};
|
|
@@ -1,25 +1,40 @@
|
|
|
1
1
|
import { FlowFormatAdapter, FlowManifest, FlowParseOptions } from "../types.js";
|
|
2
2
|
|
|
3
3
|
//#region packages/flows/src/adapters/openspec.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* OpenSpec adapter — detects repos that follow the OpenSpec workflow
|
|
6
|
+
* (https://github.com/Fission-AI/OpenSpec) and converts them to FlowManifest.
|
|
7
|
+
*
|
|
8
|
+
* Detection marker: `openspec/config.yaml` in the source directory.
|
|
9
|
+
*
|
|
10
|
+
* Flow steps are derived from the active OpenSpec schema.yaml.
|
|
11
|
+
*/
|
|
4
12
|
declare class OpenSpecAdapter implements FlowFormatAdapter {
|
|
5
13
|
readonly format: "openspec";
|
|
6
14
|
detect(sourceDir: string): boolean;
|
|
7
|
-
parse(sourceDir: string,
|
|
15
|
+
parse(sourceDir: string, options?: FlowParseOptions): Promise<FlowManifest>;
|
|
8
16
|
/**
|
|
9
17
|
* Read metadata from package.json if available, otherwise use defaults
|
|
10
18
|
* derived from the openspec config.
|
|
11
19
|
*/
|
|
12
20
|
private readMeta;
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
private
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
private
|
|
21
|
+
private readConfigSchema;
|
|
22
|
+
private resolveSchemaDir;
|
|
23
|
+
private parseSchemaArtifacts;
|
|
24
|
+
private loadSchema;
|
|
25
|
+
private discoverSchemaFromDirectory;
|
|
26
|
+
private collectMarkdownFiles;
|
|
27
|
+
private hasFileRecursive;
|
|
28
|
+
private findSchemaYaml;
|
|
29
|
+
private toStepIdFromMarkdown;
|
|
30
|
+
private buildStepsFromSchema;
|
|
31
|
+
private materializeSteps;
|
|
32
|
+
private resolveInstructionContent;
|
|
33
|
+
private normalizeArtifact;
|
|
34
|
+
private normalizeApply;
|
|
35
|
+
private readString;
|
|
36
|
+
private readStringArray;
|
|
37
|
+
private humanizeStepName;
|
|
23
38
|
}
|
|
24
39
|
//#endregion
|
|
25
40
|
export { OpenSpecAdapter };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{existsSync as e,
|
|
1
|
+
import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,writeFileSync as i}from"node:fs";import{basename as a,join as o,relative as s}from"node:path";import{execSync as c}from"node:child_process";import{parse as l}from"yaml";var u=class{format=`openspec`;detect(t){return!!(e(o(t,`openspec`,`config.yaml`))||e(o(t,`schemas`))&&this.findSchemaYaml(t))}async parse(e,t){let n=this.readMeta(e),r=this.loadSchema(e),i=this.buildStepsFromSchema(r);return await this.materializeSteps(e,i,r,t),{name:n.name,version:n.version,description:r.description??n.description,author:n.author,steps:i,agents:[],artifacts_dir:`openspec`,install:[]}}readMeta(t){let r=o(t,`package.json`);if(e(r))try{let e=JSON.parse(n(r,`utf-8`));return{name:e.name??a(t),version:e.version??`0.1.0`,description:e.description??`OpenSpec flow`,author:e.author}}catch{}return{name:a(t),version:`0.1.0`,description:`OpenSpec flow`}}readConfigSchema(t){let r=o(t,`openspec`,`config.yaml`);if(!e(r))return`spec-driven`;try{let e=l(n(r,`utf-8`));return typeof e?.schema==`string`&&e.schema.trim().length>0?e.schema:`spec-driven`}catch{return`spec-driven`}}resolveSchemaDir(t){let n=this.readConfigSchema(t),r=o(t,`openspec`,`schemas`,n);if(e(o(r,`schema.yaml`)))return r;let i=o(t,`schemas`,n);if(e(o(i,`schema.yaml`)))return i;try{let t=o(c(`npm root -g`,{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).trim(),`@fission-ai`,`openspec`,`schemas`,n);if(e(o(t,`schema.yaml`)))return t}catch{}return null}parseSchemaArtifacts(e){try{let t=l(e);if(!t||!Array.isArray(t.artifacts))return null;let n=t.artifacts.map(e=>this.normalizeArtifact(e)).filter(e=>e!==null);return n.length===0?null:{name:typeof t.name==`string`&&t.name.trim().length>0?t.name:this.readString(t.schema)??`spec-driven`,version:typeof t.version==`number`?t.version:1,description:this.readString(t.description),artifacts:n,apply:this.normalizeApply(t.apply)}}catch{return null}}loadSchema(e){let t=this.resolveSchemaDir(e);if(t){let e=o(t,`schema.yaml`);try{let t=n(e,`utf-8`),r=this.parseSchemaArtifacts(t);if(r)return r}catch{}}return this.discoverSchemaFromDirectory(e)}discoverSchemaFromDirectory(t){let i=[o(t,`openspec`,`schemas`),o(t,`schemas`)];for(let t of i)if(e(t))try{let i=r(t,{withFileTypes:!0}).filter(e=>e.isDirectory());for(let r of i){let i=o(t,r.name,`schema.yaml`);if(e(i))try{let e=this.parseSchemaArtifacts(n(i,`utf-8`));if(e)return e}catch{}}}catch{}let c=[],l=o(t,`openspec`),u=[],d=this.collectMarkdownFiles(l);for(let e of d){let t=s(l,e).replace(/\\/g,`/`),n=this.toStepIdFromMarkdown(t);!n||u.includes(n)||(c.push({id:n,generates:t,description:`${this.humanizeStepName(n)} phase`,template:a(e),requires:u.length>0?[u[u.length-1]]:[]}),u.push(n))}return{name:this.readConfigSchema(t),version:1,artifacts:c}}collectMarkdownFiles(t){if(!e(t))return[];let n=[];try{let e=r(t,{withFileTypes:!0}).sort((e,t)=>e.name.localeCompare(t.name));for(let r of e){let e=o(t,r.name);if(r.isFile()&&r.name.toLowerCase().endsWith(`.md`)){n.push(e);continue}r.isDirectory()&&n.push(...this.collectMarkdownFiles(e))}}catch{}return n}hasFileRecursive(t,n){if(!e(t))return!1;try{let e=r(t,{withFileTypes:!0});for(let r of e)if(r.isFile()&&r.name===n||r.isDirectory()&&this.hasFileRecursive(o(t,r.name),n))return!0}catch{}return!1}findSchemaYaml(t){let n=o(t,`schemas`);if(!e(n))return!1;try{return r(n,{withFileTypes:!0}).filter(e=>e.isDirectory()).some(t=>e(o(n,t.name,`schema.yaml`)))}catch{return!1}}toStepIdFromMarkdown(e){let t=e.replace(/\\/g,`/`).split(`/`).filter(Boolean);if(t.length===0)return null;let n=(t[t.length-1]??``).replace(/\.md$/i,``);return(n.toLowerCase()===`readme`&&t.length>1?t[t.length-2]:n).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|-+$/g,``)||null}buildStepsFromSchema(e){let t=e.artifacts.map(e=>({id:e.id,name:this.humanizeStepName(e.id),instruction:`steps/${e.id}/README.md`,produces:e.generates?[e.generates]:[],requires:e.requires,agents:[],description:e.description}));return e.apply&&t.push({id:`apply`,name:`Apply`,instruction:`steps/apply/README.md`,produces:[],requires:e.apply.requires,agents:[],description:`Implement the tasks, writing code and tests according to the design`}),t}async materializeSteps(n,r,a,s){let c=this.resolveSchemaDir(n),l=new Map(a.artifacts.map(e=>[e.id,e]));for(let u of r){let r=o(n,`steps`,u.id),d=o(r,`README.md`);t(r,{recursive:!0});let f=this.resolveInstructionContent(c,u.id,l.get(u.id),a.apply);if(!f){e(d)||i(d,`# ${u.name}\n\n${u.description}\n`,`utf-8`);continue}i(d,s?.transform?await s.transform({content:f,sourceFormat:`openspec`,stepName:u.id,metadata:{schemaName:a.name,displayName:u.name,description:u.description,produces:u.produces,requires:u.requires}}):`# ${u.name}\n\n${f}`,`utf-8`)}}resolveInstructionContent(t,r,i,a){if(r===`apply`&&a?.instruction)return a.instruction;if(!i)return null;if(i.instruction)return i.instruction;if(t&&i.template){let r=o(t,`templates`,i.template);if(e(r))try{return n(r,`utf-8`)}catch{}}return i.description||null}normalizeArtifact(e){if(!e||typeof e!=`object`)return null;let t=e,n=this.readString(t.id),r=this.readString(t.generates);return!n||!r?null:{id:n,generates:r,description:this.readString(t.description)??`${this.humanizeStepName(n)} phase`,template:this.readString(t.template)??``,instruction:this.readString(t.instruction),requires:this.readStringArray(t.requires)}}normalizeApply(e){if(!e||typeof e!=`object`)return;let t=e;return{requires:this.readStringArray(t.requires),tracks:this.readString(t.tracks)??null,instruction:this.readString(t.instruction)}}readString(e){return typeof e==`string`&&e.trim().length>0?e:void 0}readStringArray(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.length>0):[]}humanizeStepName(e){return e.split(/[-_]/g).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1)).join(` `)}};export{u as OpenSpecAdapter};
|
|
@@ -10,7 +10,7 @@ declare class GitInstaller {
|
|
|
10
10
|
* credential manager can open a browser / device-code flow.
|
|
11
11
|
* Returns the local install path.
|
|
12
12
|
*/
|
|
13
|
-
clone(repoUrl: string): FlowResult<string>;
|
|
13
|
+
clone(repoUrl: string, token?: string): FlowResult<string>;
|
|
14
14
|
/**
|
|
15
15
|
* Update an existing cloned flow repo.
|
|
16
16
|
*/
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{cpSync as e,existsSync as t,mkdirSync as n,rmSync as r}from"node:fs";import{basename as
|
|
2
|
-
`)}function
|
|
1
|
+
import{cpSync as e,existsSync as t,mkdirSync as n,rmSync as r,unlinkSync as i,writeFileSync as a}from"node:fs";import{basename as o,join as s}from"node:path";import{execSync as c,spawnSync as l}from"node:child_process";import{tmpdir as u}from"node:os";function d(e){if(!e||typeof e!=`object`||!(`stderr`in e))return``;let t=e.stderr;return Buffer.isBuffer(t)?t.toString().trim():typeof t==`string`?t.trim():``}function f(e){try{return new URL(e).hostname}catch{}return e.match(/^[^@]+@([^:]+):/)?.[1]??`<host>`}function p(e,t,n){let r=[`Git operation failed for: ${e}`],i=f(e),a=t.includes(`ETIMEDOUT`)||t.includes(`SIGTERM`)||t.toLowerCase().includes(`timed out`),o=n.includes(`Authentication failed`)||n.includes(`could not read Username`)||n.includes(`terminal prompts disabled`)||n.includes(`401`)||n.includes(`403`)||n.includes(`Permission denied`),s=n.includes(`SSL certificate`)||n.includes(`unable to access`)&&n.includes(`SSL`),c=n.includes(`Could not resolve host`)||n.includes(`Name or service not known`),l=n.includes(`SAML`)||n.includes(`single sign-on`);return o||l?(r.push(``),r.push(`Cause: Authentication required or credentials not configured.`),r.push(``),r.push(`To fix this, ensure git can access this repository:`),r.push(``),r.push(` Option 1 - SSH key:`),r.push(` 1. Generate an SSH key: ssh-keygen -t ed25519`),r.push(` 2. Add the public key to your Git hosting account`),r.push(` 3. Use the SSH URL instead: git@<host>:<org>/<repo>.git`),r.push(``),r.push(` Option 2 - Personal Access Token (PAT):`),r.push(` 1. Create a PAT in your Git hosting Settings > Developer settings > Tokens`),r.push(` 2. For GitHub Enterprise with SAML SSO, authorize the token for your org`),r.push(` 3. Configure git credentials:`),r.push(` git config --global credential.helper store`),r.push(` git clone ${e} (enter PAT as password)`),r.push(``),r.push(` Option 3 - Git Credential Manager:`),r.push(` 1. Install: https://github.com/git-ecosystem/git-credential-manager`),r.push(` 2. Run: git clone ${e}`),r.push(` 3. Follow the browser-based auth prompt`),r.push(``),r.push(`After configuring credentials, retry: aikit flow add ${e}`)):a?(r.push(``),r.push(`Cause: Connection timed out - the server did not respond within 60 seconds.`),r.push(``),r.push(`Possible reasons:`),r.push(` - The repository requires VPN access. Ensure your VPN is connected`),r.push(` - The host is behind a firewall or corporate proxy`),r.push(` - The URL may be incorrect`),r.push(``),r.push(`Diagnostics:`),r.push(` 1. Verify the URL is correct: ${e}`),r.push(` 2. Test connectivity: git ls-remote ${e}`),r.push(` 3. If behind a proxy, configure git:`),r.push(` git config --global http.proxy http://proxy:port`),r.push(``),r.push(`If this is a corporate/internal host, you may need to:`),r.push(` - Connect to the corporate VPN`),r.push(` - Add the host to your SSH config or git config`),r.push(` - Ask your IT team to allowlist your machine`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):s?(r.push(``),r.push(`Cause: SSL/TLS certificate verification failed.`),r.push(``),r.push(`This often happens with corporate proxies or self-signed certificates.`),r.push(``),r.push(`To fix:`),r.push(` 1. If your company uses a custom CA, add it:`),r.push(` git config --global http.sslCAInfo /path/to/ca-bundle.crt`),r.push(` 2. As a last resort (not recommended for production):`),r.push(` git config --global http.sslVerify false`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):c?(r.push(``),r.push(`Cause: Cannot resolve hostname.`),r.push(``),r.push(`Check:`),r.push(` 1. Is the URL correct? ${e}`),r.push(` 2. Are you connected to the internet/VPN?`),r.push(` 3. Can you resolve the host? ping ${i}`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)):(r.push(``),r.push(`Error: ${t}`),n&&r.push(`Details: ${n}`),r.push(``),r.push(`Troubleshooting:`),r.push(` 1. Verify the URL is a valid git repository: git ls-remote ${e}`),r.push(` 2. Check your git credentials and network connectivity`),r.push(` 3. If the repo requires auth, configure credentials first (PAT or SSH key)`),r.push(``),r.push(`After resolving, retry: aikit flow add ${e}`)),r.join(`
|
|
2
|
+
`)}function m(){try{return l(`git`,[`credential-manager`,`--version`],{stdio:`pipe`,timeout:5e3}).status===0}catch{return!1}}function h(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`authentication failed`)||n.includes(`could not read username`)||n.includes(`saml sso`)||n.includes(`terminal prompts disabled`)||n.includes(`host key verification failed`)||n.includes(`permission denied`)||n.includes(`403`)||n.includes(`401`)}var g=class{constructor(e){this.flowsDir=e}clone(e,n){let o=this.repoNameFromUrl(e),c=s(this.flowsDir,o);if(t(c))if(!t(s(c,`.git`)))r(c,{recursive:!0,force:!0});else return{success:!1,error:`Flow "${o}" already installed at ${c}. Use update instead.`};try{if(this.ensureFlowsDir(),n){let t=process.platform===`win32`?`bat`:`sh`,r=s(u(),`git-askpass-${Date.now()}.${t}`);process.platform===`win32`?a(r,`@echo ${n}`,{mode:448}):a(r,`#!/bin/sh\necho "${n}"`,{mode:448});try{let t=l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:r}});if(t.status!==0){let e=t.stderr?.toString().trim()??``;throw Error(e||t.error?.message||`git clone failed`)}}finally{try{i(r)}catch{}}}else{let t=l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:``}});if(t.status!==0){let e=t.stderr?.toString().trim()??``;throw Error(e||t.error?.message||`git clone failed`)}}return{success:!0,data:c}}catch(i){t(c)&&r(c,{recursive:!0,force:!0});let a=d(i),o=i instanceof Error?i.message:String(i);if(!n&&h(o,a)&&m()){let n=f(e)||e;console.log(`\nAuthentication required for ${n}.\nGit Credential Manager detected - opening browser for login...\n(If a browser window does not open, check your terminal for a device code.)\n`);try{if(this.ensureFlowsDir(),l(`git`,[`clone`,`--depth`,`1`,e,c],{stdio:`inherit`,timeout:12e4,env:{...process.env,GIT_TERMINAL_PROMPT:`1`}}).status===0)return{success:!0,data:c};t(c)&&r(c,{recursive:!0,force:!0})}catch{t(c)&&r(c,{recursive:!0,force:!0})}}return{success:!1,error:p(e,o,a)}}}update(e){if(!t(e))return{success:!1,error:`Install path not found: ${e}`};try{return c(`git pull --ff-only`,{cwd:e,stdio:`pipe`,timeout:6e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`,GIT_ASKPASS:``}}),{success:!0}}catch(t){let n=e;try{n=c(`git remote get-url origin`,{cwd:e,stdio:`pipe`,timeout:1e4}).toString().trim()}catch{}let r=d(t),i=t instanceof Error?t.message:String(t);if(h(i,r)&&m()){let t=f(n)||n;console.log(`\nAuthentication required for ${t}.\nGit Credential Manager detected - opening browser for login...\n`);try{if(l(`git`,[`pull`,`--ff-only`],{cwd:e,stdio:`inherit`,timeout:12e4,env:{...process.env,GIT_TERMINAL_PROMPT:`1`}}).status===0)return{success:!0}}catch{}}return{success:!1,error:p(n,i,r)}}}copyLocal(n,r){let i=s(this.flowsDir,r);if(t(i))return{success:!1,error:`Flow "${r}" already installed at ${i}`};try{return this.ensureFlowsDir(),e(n,i,{recursive:!0}),{success:!0,data:i}}catch(e){return{success:!1,error:`Copy failed: ${e instanceof Error?e.message:String(e)}`}}}remove(e){if(!t(e))return{success:!0};try{return r(e,{recursive:!0,force:!0}),{success:!0}}catch(e){return{success:!1,error:`Remove failed: ${e instanceof Error?e.message:String(e)}`}}}runInstallDeps(e){for(let t of e)try{if(t.startsWith(`npm:`)){c(`npx skills add ${t.slice(4)} -g`,{stdio:`pipe`,timeout:12e4});continue}if(t.endsWith(`.git`)||t.includes(`github.com`)){c(`npx skills add ${t} -g`,{stdio:`pipe`,timeout:12e4});continue}return{success:!1,error:`Unknown install entry format: ${t}`}}catch(e){return{success:!1,error:`Install dependency failed for "${t}": ${e instanceof Error?e.message:String(e)}`}}return{success:!0}}getLocalCommit(e){try{return c(`git rev-parse HEAD`,{cwd:e,stdio:`pipe`,timeout:1e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`}}).toString().trim()||null}catch{return null}}getRemoteCommit(e){try{return c(`git ls-remote origin HEAD`,{cwd:e,stdio:`pipe`,timeout:3e4,env:{...process.env,GIT_TERMINAL_PROMPT:`0`}}).toString().trim().split(/\s+/)[0]||null}catch{return null}}hasUpdates(e){let t=this.getLocalCommit(e);if(!t)return{success:!1,error:`Could not determine local commit (not a git repo?)`};let n=this.getRemoteCommit(e);return n?{success:!0,data:{localCommit:t,remoteCommit:n,hasUpdates:t!==n}}:{success:!1,error:`Could not reach remote to check for updates`}}repoNameFromUrl(e){return o(e).replace(/\.git$/,``)}ensureFlowsDir(){t(this.flowsDir)||n(this.flowsDir,{recursive:!0})}};export{g as GitInstaller};
|
|
@@ -1,7 +1,8 @@
|
|
|
1
|
-
import { FlowFormat, FlowFormatAdapter, FlowManifest, FlowParseOptions, FlowRegistry, FlowRegistryEntry, FlowResult, FlowSourceType, FlowState, FlowStatus, FlowStep, StepAction } from "./types.js";
|
|
1
|
+
import { ContentTransformFn, FlowFormat, FlowFormatAdapter, FlowManifest, FlowParseOptions, FlowRegistry, FlowRegistryEntry, FlowResult, FlowSourceType, FlowState, FlowStatus, FlowStep, StepAction } from "./types.js";
|
|
2
2
|
import { ClaudePluginAdapter } from "./adapters/claude-plugin.js";
|
|
3
3
|
import { CopilotAdapter } from "./adapters/copilot.js";
|
|
4
4
|
import { NativeAdapter } from "./adapters/native.js";
|
|
5
|
+
import { OpenSpecAdapter } from "./adapters/openspec.js";
|
|
5
6
|
import { BuiltinFlow, getBuiltinFlows } from "./builtins.js";
|
|
6
7
|
import { FoundationIntegration } from "./foundation.js";
|
|
7
8
|
import { GitInstaller } from "./git.js";
|
|
@@ -9,4 +10,4 @@ import { FlowLoader } from "./loader.js";
|
|
|
9
10
|
import { FlowRegistryManager } from "./registry.js";
|
|
10
11
|
import { FlowStateMachine } from "./state-machine.js";
|
|
11
12
|
import { SymlinkManager } from "./symlinks.js";
|
|
12
|
-
export { type BuiltinFlow, ClaudePluginAdapter, CopilotAdapter, type FlowFormat, type FlowFormatAdapter, FlowLoader, type FlowManifest, type FlowParseOptions, type FlowRegistry, type FlowRegistryEntry, FlowRegistryManager, type FlowResult, type FlowSourceType, type FlowState, FlowStateMachine, type FlowStatus, type FlowStep, FoundationIntegration, GitInstaller, NativeAdapter, type StepAction, SymlinkManager, getBuiltinFlows };
|
|
13
|
+
export { type BuiltinFlow, ClaudePluginAdapter, type ContentTransformFn, CopilotAdapter, type FlowFormat, type FlowFormatAdapter, FlowLoader, type FlowManifest, type FlowParseOptions, type FlowRegistry, type FlowRegistryEntry, FlowRegistryManager, type FlowResult, type FlowSourceType, type FlowState, FlowStateMachine, type FlowStatus, type FlowStep, FoundationIntegration, GitInstaller, NativeAdapter, OpenSpecAdapter, type StepAction, SymlinkManager, getBuiltinFlows };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{getBuiltinFlows as e}from"./builtins.js";import{FoundationIntegration as t}from"./foundation.js";import{GitInstaller as n}from"./git.js";import{ClaudePluginAdapter as r}from"./adapters/claude-plugin.js";import{CopilotAdapter as i}from"./adapters/copilot.js";import{NativeAdapter as a}from"./adapters/native.js";import{
|
|
1
|
+
import{getBuiltinFlows as e}from"./builtins.js";import{FoundationIntegration as t}from"./foundation.js";import{GitInstaller as n}from"./git.js";import{ClaudePluginAdapter as r}from"./adapters/claude-plugin.js";import{CopilotAdapter as i}from"./adapters/copilot.js";import{NativeAdapter as a}from"./adapters/native.js";import{OpenSpecAdapter as o}from"./adapters/openspec.js";import{FlowLoader as s}from"./loader.js";import{FlowRegistryManager as c}from"./registry.js";import{FlowStateMachine as l}from"./state-machine.js";import{SymlinkManager as u}from"./symlinks.js";export{r as ClaudePluginAdapter,i as CopilotAdapter,s as FlowLoader,c as FlowRegistryManager,l as FlowStateMachine,t as FoundationIntegration,n as GitInstaller,a as NativeAdapter,o as OpenSpecAdapter,u as SymlinkManager,e as getBuiltinFlows};
|
|
@@ -39,9 +39,15 @@ interface FlowManifest {
|
|
|
39
39
|
install: string[];
|
|
40
40
|
}
|
|
41
41
|
/** Source type for flow installation */
|
|
42
|
-
type FlowSourceType = 'builtin' | 'git' | 'local' | 'npm-global';
|
|
42
|
+
type FlowSourceType = 'builtin' | 'git' | 'local' | 'npm-global' | 'claude-plugin';
|
|
43
43
|
/** Detected format of the flow source */
|
|
44
44
|
type FlowFormat = 'native' | 'claude-plugin' | 'copilot' | 'openspec';
|
|
45
|
+
type ContentTransformFn = (request: {
|
|
46
|
+
content: string;
|
|
47
|
+
sourceFormat: FlowFormat;
|
|
48
|
+
stepName: string;
|
|
49
|
+
metadata?: Record<string, unknown>;
|
|
50
|
+
}) => Promise<string>;
|
|
45
51
|
/** Registry entry for an installed flow */
|
|
46
52
|
interface FlowRegistryEntry {
|
|
47
53
|
/** Flow name */
|
|
@@ -99,11 +105,8 @@ type StepAction = 'next' | 'skip' | 'redo';
|
|
|
99
105
|
interface FlowParseOptions {
|
|
100
106
|
/** When true, force-refresh supporting assets (e.g. on update) */
|
|
101
107
|
forceAssetSync?: boolean;
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
interface FlowParseOptions {
|
|
105
|
-
/** When true, force-refresh supporting assets (e.g. on update) */
|
|
106
|
-
forceAssetSync?: boolean;
|
|
108
|
+
/** Optional content transformer for converting foreign step content to native README.md */
|
|
109
|
+
transform?: ContentTransformFn;
|
|
107
110
|
}
|
|
108
111
|
/** Format adapter interface — converts external formats to FlowManifest */
|
|
109
112
|
interface FlowFormatAdapter {
|
|
@@ -121,4 +124,4 @@ interface FlowResult<T = void> {
|
|
|
121
124
|
error?: string;
|
|
122
125
|
}
|
|
123
126
|
//#endregion
|
|
124
|
-
export { FlowFormat, FlowFormatAdapter, FlowManifest, FlowParseOptions, FlowRegistry, FlowRegistryEntry, FlowResult, FlowSourceType, FlowState, FlowStatus, FlowStep, StepAction };
|
|
127
|
+
export { ContentTransformFn, FlowFormat, FlowFormatAdapter, FlowManifest, FlowParseOptions, FlowRegistry, FlowRegistryEntry, FlowResult, FlowSourceType, FlowState, FlowStatus, FlowStep, StepAction };
|