@mimir-labs/cli 0.1.0 → 0.2.0
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 +25 -9
- package/dist/cli.js +2 -0
- package/dist/cli.js.map +1 -1
- package/dist/commands/author.d.ts +2 -0
- package/dist/commands/author.js +60 -0
- package/dist/commands/author.js.map +1 -0
- package/dist/dx/about/command.js +1 -0
- package/dist/dx/about/command.js.map +1 -1
- package/dist/dx/command-registry/index.js +20 -0
- package/dist/dx/command-registry/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -9,8 +9,8 @@ Reference implementation CLI for APS Protocol.
|
|
|
9
9
|
|
|
10
10
|
Formal docs:
|
|
11
11
|
|
|
12
|
-
- [APS Protocol Specification v1](
|
|
13
|
-
- [APS Protocol Rationale](
|
|
12
|
+
- [APS Protocol Specification v1](https://github.com/SeaBassLab/aps-protocol/blob/main/docs/specification.md)
|
|
13
|
+
- [APS Protocol Rationale](https://github.com/SeaBassLab/aps-protocol/blob/main/docs/rationale.md)
|
|
14
14
|
|
|
15
15
|
## Introduction
|
|
16
16
|
|
|
@@ -75,10 +75,10 @@ APS gives software a single, structured, machine-readable representation of that
|
|
|
75
75
|
## Conceptual Model
|
|
76
76
|
|
|
77
77
|
```text
|
|
78
|
-
Source Code
|
|
79
|
-
|
|
|
80
|
-
v
|
|
81
|
-
mimir generate
|
|
78
|
+
Source Code mimir author
|
|
79
|
+
| |
|
|
80
|
+
v v
|
|
81
|
+
mimir generate aps/knowledge
|
|
82
82
|
|
|
|
83
83
|
v
|
|
84
84
|
APS Knowledge Base
|
|
@@ -170,6 +170,7 @@ Create your first APS Knowledge Provider:
|
|
|
170
170
|
cd my-library
|
|
171
171
|
|
|
172
172
|
mimir init
|
|
173
|
+
mimir author
|
|
173
174
|
mimir generate
|
|
174
175
|
|
|
175
176
|
# output
|
|
@@ -189,13 +190,17 @@ mimir doctor
|
|
|
189
190
|
Step summary:
|
|
190
191
|
|
|
191
192
|
- `mimir init`: prepares APS configuration in package metadata.
|
|
193
|
+
- `mimir author`: creates missing human-knowledge YAML templates under `aps/knowledge` without modifying existing files.
|
|
192
194
|
- `mimir generate`: scans your project and creates an initial APS knowledge base from observable evidence such as TypeScript exports, Storybook metadata, and package information.
|
|
193
195
|
- `mimir validate`: verifies APS structural compliance.
|
|
194
196
|
- `mimir governance`: validates governance metadata and policy consistency.
|
|
195
197
|
- `mimir doctor`: evaluates maturity level before release.
|
|
196
198
|
- Publish provider package: distributes the provider through a package registry.
|
|
197
199
|
|
|
198
|
-
|
|
200
|
+
Complete the generated authoring templates manually or with an AI agent before generation when human intent is required. Mimir does not write that content.
|
|
201
|
+
|
|
202
|
+
In this release, `author` prepares the source files only. Consuming them from
|
|
203
|
+
`generate` is a separate pipeline integration.
|
|
199
204
|
|
|
200
205
|
## Example
|
|
201
206
|
|
|
@@ -234,6 +239,10 @@ Provider project:
|
|
|
234
239
|
|
|
235
240
|
```text
|
|
236
241
|
my-ui-library/
|
|
242
|
+
aps/
|
|
243
|
+
knowledge/
|
|
244
|
+
components/
|
|
245
|
+
acme.ui.component.button.yaml
|
|
237
246
|
dist/
|
|
238
247
|
aps/
|
|
239
248
|
manifest.json
|
|
@@ -261,6 +270,7 @@ In practice, the provider publishes structured software knowledge once, and cons
|
|
|
261
270
|
|
|
262
271
|
```text
|
|
263
272
|
mimir init
|
|
273
|
+
-> mimir author
|
|
264
274
|
-> mimir generate
|
|
265
275
|
-> mimir validate
|
|
266
276
|
-> mimir governance
|
|
@@ -270,6 +280,7 @@ mimir init
|
|
|
270
280
|
|
|
271
281
|
Why each step exists:
|
|
272
282
|
|
|
283
|
+
- Author -> creates missing, version-controlled templates for human knowledge.
|
|
273
284
|
- Generate -> creates machine-readable knowledge artifacts.
|
|
274
285
|
- Validate -> ensures protocol compliance.
|
|
275
286
|
- Governance -> ensures trust, provenance, and policy consistency.
|
|
@@ -366,11 +377,13 @@ mimir governance --json
|
|
|
366
377
|
| Command | Role | Description | Example |
|
|
367
378
|
| --- | --- | --- | --- |
|
|
368
379
|
| `mimir init` | Provider | Initialize APS support in package metadata. | `mimir init` |
|
|
380
|
+
| `mimir author` | Provider | Create missing human-knowledge templates without overwriting existing files. | `mimir author --dry-run` |
|
|
369
381
|
| `mimir generate` | Provider | Generate APS resources from available evidence. | `mimir generate --force` |
|
|
370
382
|
| `mimir discover` | Consumer | Discover APS-enabled dependencies/providers. | `mimir discover` |
|
|
371
383
|
| `mimir validate` | Both | Validate APS manifest and declared resources. | `mimir validate` |
|
|
372
384
|
| `mimir governance` | Provider | Validate provenance, evidence, lifecycle, applicability and policy consistency metadata. | `mimir governance --json` |
|
|
373
385
|
| `mimir doctor` | Provider | Evaluate provider maturity (L0-L3). | `mimir doctor --json` |
|
|
386
|
+
| `mimir context` | Consumer | Generate local AI-agent context from discovered providers. | `mimir context --dry-run` |
|
|
374
387
|
| `mimir sync` | Consumer | Synchronize discovered APS knowledge to configured consumer adapters. | `mimir sync` |
|
|
375
388
|
| `mimir about` | Both | Show APS Protocol overview, workflows, and references. | `mimir about --json` |
|
|
376
389
|
| `mimir help` | Both | Show command help and usage. | `mimir help governance` |
|
|
@@ -380,8 +393,8 @@ mimir governance --json
|
|
|
380
393
|
|
|
381
394
|
| Group | Commands |
|
|
382
395
|
| --- | --- |
|
|
383
|
-
| Provider Commands | `init`, `generate`, `validate`, `governance`, `doctor` |
|
|
384
|
-
| Consumer Commands | `discover`, `sync` |
|
|
396
|
+
| Provider Commands | `init`, `author`, `generate`, `validate`, `governance`, `doctor` |
|
|
397
|
+
| Consumer Commands | `discover`, `context`, `sync` |
|
|
385
398
|
| Utility Commands | `help`, `about`, `completion` |
|
|
386
399
|
|
|
387
400
|
## Doctor
|
|
@@ -441,6 +454,9 @@ Documentation provides context and intent, while APS provides interoperable, mac
|
|
|
441
454
|
- [x] Validation
|
|
442
455
|
- [x] Governance
|
|
443
456
|
- [x] Generate v1
|
|
457
|
+
- [x] Human knowledge authoring
|
|
458
|
+
- [x] Context generation
|
|
459
|
+
- [x] Adapter sync
|
|
444
460
|
|
|
445
461
|
### Reference Providers
|
|
446
462
|
|
package/dist/cli.js
CHANGED
|
@@ -15,6 +15,7 @@ const command_2 = require("./dx/completion/command");
|
|
|
15
15
|
const constants_1 = require("./dx/branding/constants");
|
|
16
16
|
const command_3 = require("./dx/about/command");
|
|
17
17
|
const options_1 = require("./dx/runtime/options");
|
|
18
|
+
const author_1 = require("./commands/author");
|
|
18
19
|
async function runCli(argv) {
|
|
19
20
|
(0, options_1.configureRuntimeOptions)(argv);
|
|
20
21
|
const program = new commander_1.Command();
|
|
@@ -30,6 +31,7 @@ async function runCli(argv) {
|
|
|
30
31
|
program.showHelpAfterError();
|
|
31
32
|
program.helpCommand(false);
|
|
32
33
|
(0, init_1.registerInitCommand)(program);
|
|
34
|
+
(0, author_1.registerAuthorCommand)(program);
|
|
33
35
|
(0, discover_1.registerDiscoverCommand)(program);
|
|
34
36
|
(0, context_1.registerContextCommand)(program);
|
|
35
37
|
(0, validate_1.registerValidateCommand)(program);
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAgBA,wBAiCC;AAjDD,yCAAoC;AACpC,gDAA4D;AAC5D,kDAA8D;AAC9D,kDAA8D;AAC9D,sDAAkE;AAClE,0CAAsD;AACtD,0CAAsD;AACtD,kDAA8D;AAC9D,8CAA0D;AAC1D,+CAAwD;AACxD,qDAAoE;AACpE,uDAA6E;AAC7E,gDAA0D;AAC1D,kDAA+D;AAC/D,8CAA0D;AAEnD,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,IAAA,iCAAuB,EAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,2BAAe,CAAC;SACrB,WAAW,CAAC,wCAAwC,6BAAiB,EAAE,CAAC;SACxE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,gCAAgC,CAAC,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;IACvD,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC,CAAC;IAC3E,OAAO,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAE7B,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAE3B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,8BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,mCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,6BAAmB,EAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.registerAuthorCommand = registerAuthorCommand;
|
|
4
|
+
const core_1 = require("@mimir-labs/core");
|
|
5
|
+
const attach_command_help_1 = require("../dx/help/attach-command-help");
|
|
6
|
+
const cli_output_1 = require("../dx/output/cli-output");
|
|
7
|
+
const options_1 = require("../dx/runtime/options");
|
|
8
|
+
function printFiles(label, files) {
|
|
9
|
+
console.log(`${label}:`);
|
|
10
|
+
if (files.length === 0) {
|
|
11
|
+
console.log("- none");
|
|
12
|
+
return;
|
|
13
|
+
}
|
|
14
|
+
for (const file of files) {
|
|
15
|
+
console.log(`- ${file}`);
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
function registerAuthorCommand(program) {
|
|
19
|
+
const command = program
|
|
20
|
+
.command("author")
|
|
21
|
+
.description("Create human knowledge authoring files for discovered APS resources")
|
|
22
|
+
.option("--json", "Emit machine-readable authoring result")
|
|
23
|
+
.option("--dry-run", "Show missing authoring files without creating them")
|
|
24
|
+
.action(async (options) => {
|
|
25
|
+
try {
|
|
26
|
+
const report = await (0, core_1.runAuthoringWorkflow)(process.cwd(), {
|
|
27
|
+
dryRun: (0, options_1.isDryRun)()
|
|
28
|
+
});
|
|
29
|
+
if ((0, options_1.shouldEmitJson)(options.json)) {
|
|
30
|
+
(0, cli_output_1.printJson)({ command: "author", ok: true, report });
|
|
31
|
+
return;
|
|
32
|
+
}
|
|
33
|
+
if (report.dryRun) {
|
|
34
|
+
(0, cli_output_1.success)("dry-run: authoring plan ready");
|
|
35
|
+
console.log(`Discovered resources: ${report.discoveredResources}`);
|
|
36
|
+
printFiles("Would create", report.plannedFiles);
|
|
37
|
+
}
|
|
38
|
+
else {
|
|
39
|
+
(0, cli_output_1.success)(`authoring files ready in ${report.outputDir}`);
|
|
40
|
+
console.log(`Discovered resources: ${report.discoveredResources}`);
|
|
41
|
+
printFiles("Created", report.createdFiles);
|
|
42
|
+
}
|
|
43
|
+
printFiles("Existing", report.existingFiles);
|
|
44
|
+
console.log("");
|
|
45
|
+
console.log("No existing authoring files were modified.");
|
|
46
|
+
}
|
|
47
|
+
catch (error) {
|
|
48
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
49
|
+
if ((0, options_1.shouldEmitJson)(options.json)) {
|
|
50
|
+
(0, cli_output_1.printJson)({ command: "author", ok: false, error: message });
|
|
51
|
+
}
|
|
52
|
+
else {
|
|
53
|
+
(0, cli_output_1.errorMessage)(`author failed: ${message}`);
|
|
54
|
+
}
|
|
55
|
+
(0, cli_output_1.setExitCode)(cli_output_1.EXIT_CODES.GENERAL_ERROR);
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
(0, attach_command_help_1.attachCommandHelp)(command, "author");
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=author.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"author.js","sourceRoot":"","sources":["../../src/commands/author.ts"],"names":[],"mappings":";;AAwBA,sDA0CC;AAjED,2CAAwD;AACxD,wEAAmE;AACnE,wDAMiC;AACjC,mDAAiE;AAEjE,SAAS,UAAU,CAAC,KAAa,EAAE,KAAe;IAChD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,QAAQ,EAAE,wCAAwC,CAAC;SAC1D,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE;gBACvD,MAAM,EAAE,IAAA,kBAAQ,GAAE;aACnB,CAAC,CAAC;YAEH,IAAI,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,IAAA,sBAAS,EAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,IAAA,oBAAO,EAAC,+BAA+B,CAAC,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBACnE,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACN,IAAA,oBAAO,EAAC,4BAA4B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBACxD,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBACnE,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,CAAC;YAED,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,IAAI,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjC,IAAA,sBAAS,EAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,IAAA,yBAAY,EAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,IAAA,wBAAW,EAAC,uBAAU,CAAC,aAAa,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,IAAA,uCAAiB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC"}
|
package/dist/dx/about/command.js
CHANGED
|
@@ -17,6 +17,7 @@ function buildAboutPayload(command) {
|
|
|
17
17
|
version: resolveVersion(command),
|
|
18
18
|
providerWorkflow: [
|
|
19
19
|
(0, constants_1.cliCommand)("init"),
|
|
20
|
+
(0, constants_1.cliCommand)("author"),
|
|
20
21
|
(0, constants_1.cliCommand)("generate"),
|
|
21
22
|
(0, constants_1.cliCommand)("validate"),
|
|
22
23
|
(0, constants_1.cliCommand)("governance"),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/dx/about/command.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/dx/about/command.ts"],"names":[],"mappings":";;AAqDA,oDAuCC;AA3FD,qDAO+B;AAC/B,qEAAgE;AAChE,qDAAiD;AACjD,gDAAoD;AAapD,SAAS,cAAc,CAAC,OAAgB;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,OAAO;QACL,KAAK,EAAE,qBAAS;QAChB,QAAQ,EAAE,6BAAiB;QAC3B,MAAM,EAAE,2BAAe;QACvB,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC;QAChC,gBAAgB,EAAE;YAChB,IAAA,sBAAU,EAAC,MAAM,CAAC;YAClB,IAAA,sBAAU,EAAC,QAAQ,CAAC;YACpB,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,YAAY,CAAC;YACxB,IAAA,sBAAU,EAAC,QAAQ,CAAC;SACrB;QACD,gBAAgB,EAAE;YAChB,gCAAgC;YAChC,IAAA,sBAAU,EAAC,UAAU,CAAC;YACtB,IAAA,sBAAU,EAAC,MAAM,CAAC;SACnB;QACD,IAAI,EAAE,iCAAqB;QAC3B,UAAU,EAAE,8BAAkB;KAC/B,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,QAAQ,EAAE,yCAAyC,CAAC;SAC3D,MAAM,CAAC,CAAC,OAA2B,EAAE,aAAsB,EAAE,EAAE;QAC9D,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAEjD,IAAI,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAA,sBAAS,EAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,KAAK,OAAO,CAAC,QAAQ,iHAAiH,CACvI,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEL,IAAA,uCAAiB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}
|
|
@@ -22,6 +22,25 @@ const COMMANDS = [
|
|
|
22
22
|
],
|
|
23
23
|
subcommands: []
|
|
24
24
|
},
|
|
25
|
+
{
|
|
26
|
+
name: "author",
|
|
27
|
+
description: "Create human knowledge authoring files for discovered APS resources",
|
|
28
|
+
usage: `${(0, constants_1.cliCommand)("author")} [--json] [--dry-run]`,
|
|
29
|
+
examples: [(0, constants_1.cliCommand)("author"), `${(0, constants_1.cliCommand)("author")} --dry-run`, `${(0, constants_1.cliCommand)("author")} --json`],
|
|
30
|
+
flags: [
|
|
31
|
+
{ name: "--json", description: "Emit deterministic machine-readable authoring result." },
|
|
32
|
+
{ name: "--dry-run", description: "Show missing authoring files without creating them." }
|
|
33
|
+
],
|
|
34
|
+
aliases: [],
|
|
35
|
+
hidden: false,
|
|
36
|
+
category: "workflow",
|
|
37
|
+
notes: ["Creates missing YAML files and never modifies existing authoring content."],
|
|
38
|
+
exitCodes: [
|
|
39
|
+
{ code: 0, meaning: "Authoring files created or already present." },
|
|
40
|
+
{ code: 1, meaning: "Resource discovery or authoring failed." }
|
|
41
|
+
],
|
|
42
|
+
subcommands: []
|
|
43
|
+
},
|
|
25
44
|
{
|
|
26
45
|
name: "generate",
|
|
27
46
|
description: "Generate APS resources from package evidence",
|
|
@@ -190,6 +209,7 @@ const COMMANDS = [
|
|
|
190
209
|
],
|
|
191
210
|
subcommands: [
|
|
192
211
|
"init",
|
|
212
|
+
"author",
|
|
193
213
|
"generate",
|
|
194
214
|
"discover",
|
|
195
215
|
"validate",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dx/command-registry/index.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dx/command-registry/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mimir-labs/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Mimir CLI, the reference implementation for the APS Protocol",
|
|
5
5
|
"files": [
|
|
6
6
|
"dist"
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
36
|
"commander": "^12.1.0",
|
|
37
|
-
"@mimir-labs/core": "0.
|
|
37
|
+
"@mimir-labs/core": "0.2.0"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@types/node": "^22.10.1",
|