implto-tos-axi 0.1.2 → 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 CHANGED
@@ -1,6 +1,6 @@
1
1
  # implto-tos-axi
2
2
 
3
- Work with [Transformation OS](https://implto-transformation-os.web.app) from
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,23 +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. They ship inside the package, and they are separate
38
- on purpose - a session that files a ticket should not also load the guidance for process maps:
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:
40
+
41
+ ```sh
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
+ ```
45
+
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:
39
49
 
40
50
  ```sh
41
51
  npm install -g implto-tos-axi
42
- npx skills add "$(npm root -g)/implto-tos-axi" -g # all three
43
- npx skills add "$(npm root -g)/implto-tos-axi" --skill implto-tos-tasks -g # or just one
52
+ npx skills add "$(npm root -g)/implto-tos-axi" -g
44
53
  ```
45
54
 
46
- Installing from the package keeps the stubs at the version of the CLI they describe, and works
47
- without access to this repository.
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:
48
58
 
49
- | Skill | Loaded when the task is about |
50
- | ---------------------- | ---------------------------------------------------------------------- |
51
- | `implto-tos-tasks` | tracking work: matching a change to a task, filing one, closing it out |
52
- | `implto-tos-delivery` | what is being built: the component tree, estimates, delivery phases |
53
- | `implto-tos-workspace` | everything else: process maps, people, roles, systems, client threads |
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 |
54
65
 
55
66
  ## Sign in
56
67
 
@@ -182,7 +193,7 @@ Profiles are deployments, one origin each:
182
193
 
183
194
  | Profile | Origin |
184
195
  | ------- | --------------------------------------------- |
185
- | `prod` | https://implto-transformation-os.web.app |
196
+ | `prod` | https://transformation.implemented.today |
186
197
  | `dev` | https://digital-transformation-os-dev.web.app |
187
198
  | `local` | http://localhost:4000 |
188
199
 
@@ -246,7 +257,7 @@ pnpm install
246
257
  pnpm build # tsc, and chmod the bin
247
258
  pnpm test
248
259
  pnpm typecheck
249
- pnpm build:skill # regenerate the three SKILL.md stubs from src/skill.ts
260
+ pnpm build:skill # regenerate the four SKILL.md stubs from src/skill.ts
250
261
  ```
251
262
 
252
263
  The stubs are generated, and CI fails if the files on disk have drifted from the generator or if
@@ -1,7 +1,10 @@
1
1
  import { TosError } from "../errors.js";
2
2
  const MCP_PATH = "/mcp/transformation-os";
3
3
  const ORIGINS = {
4
- prod: "https://implto-transformation-os.web.app",
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"}
@@ -1,11 +1,13 @@
1
1
  /**
2
2
  * The stubs that ship with the package.
3
3
  *
4
- * Three rather than one, because a skill's description is loaded whether or
5
- * not the task needs it while its body is loaded only when the description
6
- * matched. One stub covering tasks, components and everything else would put
7
- * the whole product in front of a model that only wanted to file a ticket.
8
- * Split by the question being asked, each body is pulled on its own.
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 = `---
@@ -1 +1 @@
1
- {"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/skill.ts"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,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,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAE/E,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"}
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"}
@@ -2,4 +2,4 @@
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 declare const VERSION = "0.1.2";
5
+ export declare const VERSION = "0.1.3";
@@ -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.2"; // x-release-please-version
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.2",
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.