implto-tos-axi 0.1.1 → 0.1.3
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/README.md +27 -13
- package/dist/src/auth/open-browser.d.ts +12 -3
- package/dist/src/auth/open-browser.js +18 -5
- package/dist/src/auth/open-browser.js.map +1 -1
- package/dist/src/commands/login.js +5 -2
- package/dist/src/commands/login.js.map +1 -1
- package/dist/src/config/profiles.js +4 -1
- package/dist/src/config/profiles.js.map +1 -1
- package/dist/src/skill.d.ts +7 -5
- package/dist/src/skill.js +42 -1
- package/dist/src/skill.js.map +1 -1
- package/dist/src/version.d.ts +1 -1
- package/dist/src/version.js +1 -1
- package/package.json +1 -1
- package/skills/implto-tos-axi/SKILL.md +46 -0
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# implto-tos-axi
|
|
2
2
|
|
|
3
|
-
Work with [Transformation OS](https://
|
|
3
|
+
Work with [Transformation OS](https://transformation.implemented.today) from
|
|
4
4
|
the repository you are changing: find the task a change belongs to, keep the deliverables tree
|
|
5
5
|
honest, and reach every other tool the platform has - without carrying fifty tool schemas in
|
|
6
6
|
every model request. Built to [AXI](https://github.com/kunchenguid/axi) conventions, so an agent
|
|
@@ -34,20 +34,34 @@ Or run it without installing anything:
|
|
|
34
34
|
npx -y implto-tos-axi whoami
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
To let an agent drive it, add the skills.
|
|
38
|
-
|
|
37
|
+
To let an agent drive it, add the skills. `npx skills add` installs them for every agent it finds
|
|
38
|
+
on the machine - Claude Code, Codex, Cursor and the rest - so whichever one you are working in
|
|
39
|
+
can discover the tool:
|
|
39
40
|
|
|
40
41
|
```sh
|
|
41
|
-
npx skills add implementedtoday/implto-tos-axi
|
|
42
|
-
npx skills add implementedtoday/implto-tos-axi --skill implto-tos-
|
|
43
|
-
npx skills add implementedtoday/implto-tos-axi --skill implto-tos-workspace -g
|
|
42
|
+
npx skills add implementedtoday/implto-tos-axi -g # all four
|
|
43
|
+
npx skills add implementedtoday/implto-tos-axi --skill implto-tos-axi -g # or just one
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
46
|
+
That reads them from this repository, which is private, so it needs a GitHub account with access.
|
|
47
|
+
Without one, install them from the npm package instead - they ship inside it, at the version of
|
|
48
|
+
the CLI they describe:
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
npm install -g implto-tos-axi
|
|
52
|
+
npx skills add "$(npm root -g)/implto-tos-axi" -g
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
They are separate on purpose. Every installed skill's description is in front of the agent all
|
|
56
|
+
the time, but a skill's body loads only when its description matches, so a session that files a
|
|
57
|
+
ticket does not also pay for the guidance on process maps:
|
|
58
|
+
|
|
59
|
+
| Skill | Loaded when the task is about |
|
|
60
|
+
| ---------------------- | -------------------------------------------------------------------------------- |
|
|
61
|
+
| `implto-tos-axi` | the tool itself: installing it, signing in, binding a repository, what it can do |
|
|
62
|
+
| `implto-tos-tasks` | tracking work: matching a change to a task, filing one, closing it out |
|
|
63
|
+
| `implto-tos-delivery` | what is being built: the component tree, estimates, delivery phases |
|
|
64
|
+
| `implto-tos-workspace` | everything else: process maps, people, roles, systems, client threads |
|
|
51
65
|
|
|
52
66
|
## Sign in
|
|
53
67
|
|
|
@@ -179,7 +193,7 @@ Profiles are deployments, one origin each:
|
|
|
179
193
|
|
|
180
194
|
| Profile | Origin |
|
|
181
195
|
| ------- | --------------------------------------------- |
|
|
182
|
-
| `prod` | https://
|
|
196
|
+
| `prod` | https://transformation.implemented.today |
|
|
183
197
|
| `dev` | https://digital-transformation-os-dev.web.app |
|
|
184
198
|
| `local` | http://localhost:4000 |
|
|
185
199
|
|
|
@@ -243,7 +257,7 @@ pnpm install
|
|
|
243
257
|
pnpm build # tsc, and chmod the bin
|
|
244
258
|
pnpm test
|
|
245
259
|
pnpm typecheck
|
|
246
|
-
pnpm build:skill # regenerate the
|
|
260
|
+
pnpm build:skill # regenerate the four SKILL.md stubs from src/skill.ts
|
|
247
261
|
```
|
|
248
262
|
|
|
249
263
|
The stubs are generated, and CI fails if the files on disk have drifted from the generator or if
|
|
@@ -2,8 +2,17 @@
|
|
|
2
2
|
* Hands a URL to whatever opens links on this machine.
|
|
3
3
|
*
|
|
4
4
|
* No dependency for three lines of `spawn`, and deliberately fire-and-forget:
|
|
5
|
-
* the URL
|
|
6
|
-
* person pastes it. Detached and with stdio ignored so a
|
|
7
|
-
* open does not hold the CLI's exit.
|
|
5
|
+
* `login` prints the URL before calling this, so failing to open anything is
|
|
6
|
+
* survivable - the person pastes it. Detached and with stdio ignored so a
|
|
7
|
+
* browser that stays open does not hold the CLI's exit.
|
|
8
8
|
*/
|
|
9
9
|
export declare function openBrowser(url: string): void;
|
|
10
|
+
/**
|
|
11
|
+
* Starts a program and forgets it, whether or not it exists.
|
|
12
|
+
*
|
|
13
|
+
* A missing program is not a thrown error: `spawn` reports ENOENT later, as an
|
|
14
|
+
* `error` event, and an `error` event nobody listens for takes the whole
|
|
15
|
+
* process down. On a server or in a container with no `xdg-open` that turned
|
|
16
|
+
* `login` into a crash instead of a line saying where to go.
|
|
17
|
+
*/
|
|
18
|
+
export declare function launch(command: string, args: readonly string[]): void;
|
|
@@ -4,9 +4,9 @@ import { platform } from "node:os";
|
|
|
4
4
|
* Hands a URL to whatever opens links on this machine.
|
|
5
5
|
*
|
|
6
6
|
* No dependency for three lines of `spawn`, and deliberately fire-and-forget:
|
|
7
|
-
* the URL
|
|
8
|
-
* person pastes it. Detached and with stdio ignored so a
|
|
9
|
-
* open does not hold the CLI's exit.
|
|
7
|
+
* `login` prints the URL before calling this, so failing to open anything is
|
|
8
|
+
* survivable - the person pastes it. Detached and with stdio ignored so a
|
|
9
|
+
* browser that stays open does not hold the CLI's exit.
|
|
10
10
|
*/
|
|
11
11
|
export function openBrowser(url) {
|
|
12
12
|
const [command, args] = platform() === "darwin"
|
|
@@ -14,11 +14,24 @@ export function openBrowser(url) {
|
|
|
14
14
|
: platform() === "win32"
|
|
15
15
|
? ["cmd", ["/c", "start", "", url]]
|
|
16
16
|
: ["xdg-open", [url]];
|
|
17
|
+
launch(command, args);
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Starts a program and forgets it, whether or not it exists.
|
|
21
|
+
*
|
|
22
|
+
* A missing program is not a thrown error: `spawn` reports ENOENT later, as an
|
|
23
|
+
* `error` event, and an `error` event nobody listens for takes the whole
|
|
24
|
+
* process down. On a server or in a container with no `xdg-open` that turned
|
|
25
|
+
* `login` into a crash instead of a line saying where to go.
|
|
26
|
+
*/
|
|
27
|
+
export function launch(command, args) {
|
|
17
28
|
try {
|
|
18
|
-
spawn(command, args, { detached: true, stdio: "ignore" })
|
|
29
|
+
const child = spawn(command, args, { detached: true, stdio: "ignore" });
|
|
30
|
+
child.on("error", () => undefined);
|
|
31
|
+
child.unref();
|
|
19
32
|
}
|
|
20
33
|
catch {
|
|
21
|
-
//
|
|
34
|
+
// Synchronous failures (a bad argument) are just as ignorable.
|
|
22
35
|
}
|
|
23
36
|
}
|
|
24
37
|
//# sourceMappingURL=open-browser.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../../src/auth/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GACnB,QAAQ,EAAE,KAAK,QAAQ;QACrB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,QAAQ,EAAE,KAAK,OAAO;YACtB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../../src/auth/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GACnB,QAAQ,EAAE,KAAK,QAAQ;QACrB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,QAAQ,EAAE,KAAK,OAAO;YACtB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,IAAuB;IAC7D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnC,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC"}
|
|
@@ -74,8 +74,11 @@ export async function loginCommand(argv) {
|
|
|
74
74
|
.join(" ");
|
|
75
75
|
const timeoutMs = (flags["timeout"] ?? 300) * 1000;
|
|
76
76
|
const loopback = await startLoopback({ issuer: profile.origin, timeoutMs });
|
|
77
|
-
const
|
|
78
|
-
|
|
77
|
+
const provider = new FileAuthProvider(profile, loopback.redirectUri, loopback.state, `${scope} offline_access`,
|
|
78
|
+
// Printed the moment it exists, on stderr: stdout carries the one result
|
|
79
|
+
// at the end, and the address is no use by then. Wherever no browser can
|
|
80
|
+
// be opened - over SSH, in a container - this line is the only way in.
|
|
81
|
+
(url) => process.stderr.write(`Sign in to ${profile.name} in the browser. If nothing opened, visit:\n ${url.toString()}\n`));
|
|
79
82
|
try {
|
|
80
83
|
// The SDK does discovery, registration and the authorization request; it
|
|
81
84
|
// answers REDIRECT once the browser has been sent somewhere.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/commands/login.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"login.js","sourceRoot":"","sources":["../../../src/commands/login.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { TosError } from "../errors.js";
|
|
2
2
|
const MCP_PATH = "/mcp/transformation-os";
|
|
3
3
|
const ORIGINS = {
|
|
4
|
-
|
|
4
|
+
// The custom domain, not the `web.app` address that serves the same site:
|
|
5
|
+
// the origin is the OAuth issuer, so it has to be the one production
|
|
6
|
+
// publishes as its own, and that is the address people are sent to.
|
|
7
|
+
prod: "https://transformation.implemented.today",
|
|
5
8
|
dev: "https://digital-transformation-os-dev.web.app",
|
|
6
9
|
local: "http://localhost:4000",
|
|
7
10
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../src/config/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAoBxC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C,MAAM,OAAO,GAA2B;IACtC,IAAI,EAAE,0CAA0C;IAChD,GAAG,EAAE,+CAA+C;IACpD,KAAK,EAAE,uBAAuB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACjE,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAExE,MAAM,UAAU,cAAc,CAAC,KAI9B;IACC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAAC,oBAAoB,KAAK,CAAC,OAAO,IAAI,EAAE,kBAAkB,EAAE;YAC5E,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvC,oDAAoD;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,IAAI,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,OAAO;QACL,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;QACtC,MAAM;QACN,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,EAAE,MAAM,IAAI,GAAG,MAAM,GAAG,QAAQ,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,MAAM,CAAC,MAAc;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IACrF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAW,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,iBAAiB,EAAE,kBAAkB,EAAE;YAC/D,2DAA2D;SAC5D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
|
|
1
|
+
{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../src/config/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAoBxC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C,MAAM,OAAO,GAA2B;IACtC,0EAA0E;IAC1E,qEAAqE;IACrE,oEAAoE;IACpE,IAAI,EAAE,0CAA0C;IAChD,GAAG,EAAE,+CAA+C;IACpD,KAAK,EAAE,uBAAuB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACjE,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAExE,MAAM,UAAU,cAAc,CAAC,KAI9B;IACC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,IAAI,KAAK,EAAE,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,MAAM,IAAI,QAAQ,CAAC,oBAAoB,KAAK,CAAC,OAAO,IAAI,EAAE,kBAAkB,EAAE;YAC5E,aAAa,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvC,oDAAoD;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,IAAI,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,OAAO;QACL,yEAAyE;QACzE,yEAAyE;QACzE,0EAA0E;QAC1E,IAAI,EAAE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;QACtC,MAAM;QACN,0EAA0E;QAC1E,qEAAqE;QACrE,MAAM,EAAE,MAAM,IAAI,GAAG,MAAM,GAAG,QAAQ,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,MAAM,CAAC,MAAc;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IACrF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAW,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,iBAAiB,EAAE,kBAAkB,EAAE;YAC/D,2DAA2D;SAC5D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
|
package/dist/src/skill.d.ts
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The stubs that ship with the package.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
* not the task needs it while its body is loaded only when the
|
|
6
|
-
* matched. One stub covering tasks, components and everything else
|
|
7
|
-
* the whole product in front of a model that only wanted to file a
|
|
8
|
-
*
|
|
4
|
+
* Split by the question being asked, because a skill's description is loaded
|
|
5
|
+
* whether or not the task needs it while its body is loaded only when the
|
|
6
|
+
* description matched. One stub covering tasks, components and everything else
|
|
7
|
+
* would put the whole product in front of a model that only wanted to file a
|
|
8
|
+
* ticket. The overview, named after the tool, answers questions about the tool
|
|
9
|
+
* itself - installing, signing in, what it can do - and hands the work to the
|
|
10
|
+
* other three, so it does not compete with them for the same request.
|
|
9
11
|
*
|
|
10
12
|
* All three are discovery stubs, not manuals: they say when to reach for the
|
|
11
13
|
* CLI and send the reader to `--help` and `guide` for anything that can go
|
package/dist/src/skill.js
CHANGED
|
@@ -7,6 +7,47 @@
|
|
|
7
7
|
* manual would give back exactly what was bought.
|
|
8
8
|
*/
|
|
9
9
|
export const MAX_SKILL_MARKDOWN_CHARS = 2500;
|
|
10
|
+
const OVERVIEW = {
|
|
11
|
+
name: "implto-tos-axi",
|
|
12
|
+
description: "The implto-tos-axi CLI - Transformation OS for coding agents, without mounting its MCP server. Use when the person mentions implto-tos-axi or Transformation OS and the question is the tool itself: installing it, signing in, binding a repository to a project, what it can do, or an error it returned. For the work itself, implto-tos-tasks, implto-tos-delivery and implto-tos-workspace take over.",
|
|
13
|
+
tags: ["transformation-os", "cli", "mcp", "tasks", "components"],
|
|
14
|
+
category: "workflow",
|
|
15
|
+
body: `# implto-tos-axi
|
|
16
|
+
|
|
17
|
+
A command-line client of the Transformation OS MCP server. It reaches the whole
|
|
18
|
+
server - tasks, the deliverables tree, process maps, people, the client
|
|
19
|
+
conversation - without loading its tool schemas into every prompt: a command
|
|
20
|
+
fetches only what it needs, when it runs.
|
|
21
|
+
|
|
22
|
+
## What it covers
|
|
23
|
+
|
|
24
|
+
- **Tasks** - find the task a change belongs to, file one, move its status,
|
|
25
|
+
leave a note. \`tasks --help\`; the \`implto-tos-tasks\` skill.
|
|
26
|
+
- **Components** - the deliverables tree: draw it, create one, re-parent it,
|
|
27
|
+
link it to a project or system. \`components --help\`; \`implto-tos-delivery\`.
|
|
28
|
+
- **Every other tool** - \`tools\` lists the server's areas, \`tools show\`
|
|
29
|
+
one tool's arguments, \`tools call\` runs it. \`implto-tos-workspace\`.
|
|
30
|
+
|
|
31
|
+
## Getting started
|
|
32
|
+
|
|
33
|
+
Commands and flags move; \`implto-tos-axi --help\` and \`implto-tos-axi guide
|
|
34
|
+
<topic>\` are the truth, not this file - installed copies go stale.
|
|
35
|
+
|
|
36
|
+
1. Run it as \`npx -y implto-tos-axi <command>\`, or \`npm install -g implto-tos-axi\`.
|
|
37
|
+
2. Bare \`implto-tos-axi\` says where things stand - signed in or not, bound
|
|
38
|
+
or not - and what to run next.
|
|
39
|
+
3. Signing in opens a browser, so it is the person's step: ask them to run
|
|
40
|
+
\`implto-tos-axi login\` (\`--profile dev\` for dev). \`NEEDS_HUMAN\` means
|
|
41
|
+
exactly that. A headless machine uses \`TOS_TOKEN\` instead.
|
|
42
|
+
4. \`implto-tos-axi init\` binds the repository to a workspace and project;
|
|
43
|
+
run bare, it lists what the person can reach.
|
|
44
|
+
5. \`implto-tos-axi context\` once per session, before anything else.
|
|
45
|
+
|
|
46
|
+
Every result ends with a \`help\` list naming what to run next, and so does
|
|
47
|
+
every error. Exit 2 is the caller's mistake - a bad flag, a name that matches
|
|
48
|
+
nothing or several.
|
|
49
|
+
`,
|
|
50
|
+
};
|
|
10
51
|
const TASKS = {
|
|
11
52
|
name: "implto-tos-tasks",
|
|
12
53
|
description: "Find, create and update Transformation OS tasks for the repository you are working in, through the implto-tos-axi CLI. Use when a coding task should be tracked: at the start of a session to see the bound project and your open tasks, before starting a change to match it to an existing task or file a new one, and after finishing to move the status and leave a note.",
|
|
@@ -130,7 +171,7 @@ Worth knowing before the first call:
|
|
|
130
171
|
the person to sign in again with that area.
|
|
131
172
|
`,
|
|
132
173
|
};
|
|
133
|
-
export const SKILLS = [TASKS, DELIVERY, WORKSPACE];
|
|
174
|
+
export const SKILLS = [OVERVIEW, TASKS, DELIVERY, WORKSPACE];
|
|
134
175
|
/** The stub as it ships, frontmatter included. */
|
|
135
176
|
export function createSkillMarkdown(skill) {
|
|
136
177
|
const frontmatter = `---
|
package/dist/src/skill.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,MAAM,QAAQ,GAAoB;IAChC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,4YAA4Y;IAC9Y,IAAI,EAAE,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC;IAChE,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCP;CACA,CAAC;AAEF,MAAM,KAAK,GAAoB;IAC7B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,+WAA+W;IACjX,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,mBAAmB,CAAC;IACpE,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCP;CACA,CAAC;AAEF,MAAM,QAAQ,GAAoB;IAChC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,ubAAub;IACzb,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC;IAChF,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCP;CACA,CAAC;AAEF,MAAM,SAAS,GAAoB;IACjC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,+XAA+X;IACjY,IAAI,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;IAClF,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCP;CACA,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAA+B,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEzF,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,MAAM,WAAW,GAAG;QACd,KAAK,CAAC,IAAI;gBACF,KAAK,CAAC,WAAW;;;;;;aAMpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClB,KAAK,CAAC,QAAQ;IAC1B,CAAC;IACH,OAAO,GAAG,WAAW,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC"}
|
package/dist/src/version.d.ts
CHANGED
package/dist/src/version.js
CHANGED
|
@@ -2,5 +2,5 @@
|
|
|
2
2
|
* Kept in its own leaf module so `--version` costs no module graph: the binary
|
|
3
3
|
* answers it before importing anything else. release-please rewrites the line.
|
|
4
4
|
*/
|
|
5
|
-
export const VERSION = "0.1.
|
|
5
|
+
export const VERSION = "0.1.3"; // x-release-please-version
|
|
6
6
|
//# sourceMappingURL=version.js.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "implto-tos-axi",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "Work with Transformation OS from a repository - match a change to its task, keep the deliverables tree honest, and reach every MCP tool the server has, without carrying their schemas in a prompt",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: implto-tos-axi
|
|
3
|
+
description: "The implto-tos-axi CLI - Transformation OS for coding agents, without mounting its MCP server. Use when the person mentions implto-tos-axi or Transformation OS and the question is the tool itself: installing it, signing in, binding a repository to a project, what it can do, or an error it returned. For the work itself, implto-tos-tasks, implto-tos-delivery and implto-tos-workspace take over."
|
|
4
|
+
user-invocable: false
|
|
5
|
+
author: Valentyn Morenko
|
|
6
|
+
license: MIT
|
|
7
|
+
metadata:
|
|
8
|
+
hermes:
|
|
9
|
+
tags: [transformation-os, cli, mcp, tasks, components]
|
|
10
|
+
category: workflow
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# implto-tos-axi
|
|
14
|
+
|
|
15
|
+
A command-line client of the Transformation OS MCP server. It reaches the whole
|
|
16
|
+
server - tasks, the deliverables tree, process maps, people, the client
|
|
17
|
+
conversation - without loading its tool schemas into every prompt: a command
|
|
18
|
+
fetches only what it needs, when it runs.
|
|
19
|
+
|
|
20
|
+
## What it covers
|
|
21
|
+
|
|
22
|
+
- **Tasks** - find the task a change belongs to, file one, move its status,
|
|
23
|
+
leave a note. `tasks --help`; the `implto-tos-tasks` skill.
|
|
24
|
+
- **Components** - the deliverables tree: draw it, create one, re-parent it,
|
|
25
|
+
link it to a project or system. `components --help`; `implto-tos-delivery`.
|
|
26
|
+
- **Every other tool** - `tools` lists the server's areas, `tools show`
|
|
27
|
+
one tool's arguments, `tools call` runs it. `implto-tos-workspace`.
|
|
28
|
+
|
|
29
|
+
## Getting started
|
|
30
|
+
|
|
31
|
+
Commands and flags move; `implto-tos-axi --help` and `implto-tos-axi guide
|
|
32
|
+
<topic>` are the truth, not this file - installed copies go stale.
|
|
33
|
+
|
|
34
|
+
1. Run it as `npx -y implto-tos-axi <command>`, or `npm install -g implto-tos-axi`.
|
|
35
|
+
2. Bare `implto-tos-axi` says where things stand - signed in or not, bound
|
|
36
|
+
or not - and what to run next.
|
|
37
|
+
3. Signing in opens a browser, so it is the person's step: ask them to run
|
|
38
|
+
`implto-tos-axi login` (`--profile dev` for dev). `NEEDS_HUMAN` means
|
|
39
|
+
exactly that. A headless machine uses `TOS_TOKEN` instead.
|
|
40
|
+
4. `implto-tos-axi init` binds the repository to a workspace and project;
|
|
41
|
+
run bare, it lists what the person can reach.
|
|
42
|
+
5. `implto-tos-axi context` once per session, before anything else.
|
|
43
|
+
|
|
44
|
+
Every result ends with a `help` list naming what to run next, and so does
|
|
45
|
+
every error. Exit 2 is the caller's mistake - a bad flag, a name that matches
|
|
46
|
+
nothing or several.
|