@clossys/launcher 0.3.0 → 0.4.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 +1328 -60
- package/contracts/conversation-contract.md +2 -1
- package/contracts/product-ci-workflow.yml +74 -0
- package/contracts/repository-inventory.json +53 -0
- package/dist/admission-fixture.d.ts +168 -0
- package/dist/admission-fixture.d.ts.map +1 -0
- package/dist/admission-fixture.js +453 -0
- package/dist/admission-fixture.js.map +1 -0
- package/dist/admission.d.ts +124 -0
- package/dist/admission.d.ts.map +1 -0
- package/dist/admission.js +799 -0
- package/dist/admission.js.map +1 -0
- package/dist/agents-guide.d.ts +9 -0
- package/dist/agents-guide.d.ts.map +1 -0
- package/dist/agents-guide.js +26 -0
- package/dist/agents-guide.js.map +1 -0
- package/dist/apply-command-options.check.d.ts +12 -0
- package/dist/apply-command-options.check.d.ts.map +1 -0
- package/dist/apply-command-options.check.js +20 -0
- package/dist/apply-command-options.check.js.map +1 -0
- package/dist/apply-plan-cli.d.ts +39 -1
- package/dist/apply-plan-cli.d.ts.map +1 -1
- package/dist/apply-plan-cli.js +432 -15
- package/dist/apply-plan-cli.js.map +1 -1
- package/dist/apply-plan.d.ts +46 -59
- package/dist/apply-plan.d.ts.map +1 -1
- package/dist/apply-plan.js +112 -97
- package/dist/apply-plan.js.map +1 -1
- package/dist/apply-step-fixture.d.ts +87 -0
- package/dist/apply-step-fixture.d.ts.map +1 -0
- package/dist/apply-step-fixture.js +199 -0
- package/dist/apply-step-fixture.js.map +1 -0
- package/dist/apply-store.d.ts +93 -0
- package/dist/apply-store.d.ts.map +1 -0
- package/dist/apply-store.js +625 -0
- package/dist/apply-store.js.map +1 -0
- package/dist/approval-sheet.d.ts +21 -0
- package/dist/approval-sheet.d.ts.map +1 -0
- package/dist/approval-sheet.js +157 -0
- package/dist/approval-sheet.js.map +1 -0
- package/dist/body-command.d.ts +42 -0
- package/dist/body-command.d.ts.map +1 -0
- package/dist/body-command.js +143 -0
- package/dist/body-command.js.map +1 -0
- package/dist/change-set-contract.d.ts +381 -0
- package/dist/change-set-contract.d.ts.map +1 -0
- package/dist/change-set-contract.js +738 -0
- package/dist/change-set-contract.js.map +1 -0
- package/dist/change-set-digest.d.ts +28 -0
- package/dist/change-set-digest.d.ts.map +1 -0
- package/dist/change-set-digest.js +65 -0
- package/dist/change-set-digest.js.map +1 -0
- package/dist/check-cli.d.ts.map +1 -1
- package/dist/check-cli.js +14 -3
- package/dist/check-cli.js.map +1 -1
- package/dist/cli.d.ts +17 -6
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +84 -23
- package/dist/cli.js.map +1 -1
- package/dist/core.d.ts +79 -22
- package/dist/core.d.ts.map +1 -1
- package/dist/core.js +843 -268
- package/dist/core.js.map +1 -1
- package/dist/dry-materialize.d.ts +63 -0
- package/dist/dry-materialize.d.ts.map +1 -0
- package/dist/dry-materialize.js +330 -0
- package/dist/dry-materialize.js.map +1 -0
- package/dist/generated/contract-schema.generated.d.ts +97 -0
- package/dist/generated/contract-schema.generated.d.ts.map +1 -0
- package/dist/generated/contract-schema.generated.js +496 -0
- package/dist/generated/contract-schema.generated.js.map +1 -0
- package/dist/generated/package-scope.generated.d.ts +6 -0
- package/dist/generated/package-scope.generated.d.ts.map +1 -0
- package/dist/generated/package-scope.generated.js +10 -0
- package/dist/generated/package-scope.generated.js.map +1 -0
- package/dist/generated/plan-contracts.generated.d.ts +3 -0
- package/dist/generated/plan-contracts.generated.d.ts.map +1 -0
- package/dist/generated/plan-contracts.generated.js +2840 -0
- package/dist/generated/plan-contracts.generated.js.map +1 -0
- package/dist/host.d.ts.map +1 -1
- package/dist/host.js +11 -0
- package/dist/host.js.map +1 -1
- package/dist/identity.d.ts +15 -0
- package/dist/identity.d.ts.map +1 -0
- package/dist/identity.js +48 -0
- package/dist/identity.js.map +1 -0
- package/dist/index.d.ts +34 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +19 -2
- package/dist/index.js.map +1 -1
- package/dist/inventory-adoption.d.ts +24 -5
- package/dist/inventory-adoption.d.ts.map +1 -1
- package/dist/inventory-adoption.js +70 -25
- package/dist/inventory-adoption.js.map +1 -1
- package/dist/inventory-choice.d.ts +40 -0
- package/dist/inventory-choice.d.ts.map +1 -0
- package/dist/inventory-choice.js +156 -0
- package/dist/inventory-choice.js.map +1 -0
- package/dist/inventory-contract.d.ts +89 -0
- package/dist/inventory-contract.d.ts.map +1 -0
- package/dist/inventory-contract.js +121 -0
- package/dist/inventory-contract.js.map +1 -0
- package/dist/key-editor.d.ts +30 -0
- package/dist/key-editor.d.ts.map +1 -0
- package/dist/key-editor.js +445 -0
- package/dist/key-editor.js.map +1 -0
- package/dist/ledger-contract.d.ts +187 -0
- package/dist/ledger-contract.d.ts.map +1 -0
- package/dist/ledger-contract.js +532 -0
- package/dist/ledger-contract.js.map +1 -0
- package/dist/ledger-trust.d.ts +90 -0
- package/dist/ledger-trust.d.ts.map +1 -0
- package/dist/ledger-trust.js +198 -0
- package/dist/ledger-trust.js.map +1 -0
- package/dist/lockfile-invariants.d.ts +48 -0
- package/dist/lockfile-invariants.d.ts.map +1 -0
- package/dist/lockfile-invariants.js +375 -0
- package/dist/lockfile-invariants.js.map +1 -0
- package/dist/lockfile-readers.d.ts +72 -0
- package/dist/lockfile-readers.d.ts.map +1 -0
- package/dist/lockfile-readers.js +713 -0
- package/dist/lockfile-readers.js.map +1 -0
- package/dist/lockfile-regen.d.ts +106 -0
- package/dist/lockfile-regen.d.ts.map +1 -0
- package/dist/lockfile-regen.js +760 -0
- package/dist/lockfile-regen.js.map +1 -0
- package/dist/lockfile-tool-env.d.ts +29 -0
- package/dist/lockfile-tool-env.d.ts.map +1 -0
- package/dist/lockfile-tool-env.js +111 -0
- package/dist/lockfile-tool-env.js.map +1 -0
- package/dist/materialize.d.ts +113 -0
- package/dist/materialize.d.ts.map +1 -0
- package/dist/materialize.js +840 -0
- package/dist/materialize.js.map +1 -0
- package/dist/observe-repository.d.ts +90 -0
- package/dist/observe-repository.d.ts.map +1 -0
- package/dist/observe-repository.js +1367 -0
- package/dist/observe-repository.js.map +1 -0
- package/dist/plan-bundle-setup-fixture.d.ts +68 -0
- package/dist/plan-bundle-setup-fixture.d.ts.map +1 -0
- package/dist/plan-bundle-setup-fixture.js +167 -0
- package/dist/plan-bundle-setup-fixture.js.map +1 -0
- package/dist/plan-bundle.d.ts +250 -0
- package/dist/plan-bundle.d.ts.map +1 -0
- package/dist/plan-bundle.js +827 -0
- package/dist/plan-bundle.js.map +1 -0
- package/dist/plan-command.d.ts +29 -0
- package/dist/plan-command.d.ts.map +1 -0
- package/dist/plan-command.js +493 -0
- package/dist/plan-command.js.map +1 -0
- package/dist/plan-contract.d.ts +153 -0
- package/dist/plan-contract.d.ts.map +1 -0
- package/dist/plan-contract.js +61 -0
- package/dist/plan-contract.js.map +1 -0
- package/dist/plan-digest.d.ts +25 -0
- package/dist/plan-digest.d.ts.map +1 -0
- package/dist/plan-digest.js +106 -0
- package/dist/plan-digest.js.map +1 -0
- package/dist/plan-rules.d.ts +23 -0
- package/dist/plan-rules.d.ts.map +1 -0
- package/dist/plan-rules.js +177 -0
- package/dist/plan-rules.js.map +1 -0
- package/dist/planned-bundle.d.ts +20 -0
- package/dist/planned-bundle.d.ts.map +1 -0
- package/dist/planned-bundle.js +191 -0
- package/dist/planned-bundle.js.map +1 -0
- package/dist/product-repository.d.ts +4 -0
- package/dist/product-repository.d.ts.map +1 -1
- package/dist/product-repository.js +9 -1
- package/dist/product-repository.js.map +1 -1
- package/dist/provenance-gate.d.ts +48 -0
- package/dist/provenance-gate.d.ts.map +1 -0
- package/dist/provenance-gate.js +324 -0
- package/dist/provenance-gate.js.map +1 -0
- package/dist/pull-request-body.d.ts +45 -0
- package/dist/pull-request-body.d.ts.map +1 -0
- package/dist/pull-request-body.js +232 -0
- package/dist/pull-request-body.js.map +1 -0
- package/dist/registry-snapshot.d.ts +141 -0
- package/dist/registry-snapshot.d.ts.map +1 -0
- package/dist/registry-snapshot.js +483 -0
- package/dist/registry-snapshot.js.map +1 -0
- package/dist/release-age-edit.d.ts +52 -0
- package/dist/release-age-edit.d.ts.map +1 -0
- package/dist/release-age-edit.js +413 -0
- package/dist/release-age-edit.js.map +1 -0
- package/dist/root-entries.d.ts +36 -0
- package/dist/root-entries.d.ts.map +1 -0
- package/dist/root-entries.js +80 -0
- package/dist/root-entries.js.map +1 -0
- package/dist/setup-template-scripts.d.ts +34 -0
- package/dist/setup-template-scripts.d.ts.map +1 -0
- package/dist/setup-template-scripts.js +557 -0
- package/dist/setup-template-scripts.js.map +1 -0
- package/dist/setup-templates.d.ts +54 -0
- package/dist/setup-templates.d.ts.map +1 -0
- package/dist/setup-templates.js +427 -0
- package/dist/setup-templates.js.map +1 -0
- package/dist/skills.d.ts +34 -1
- package/dist/skills.d.ts.map +1 -1
- package/dist/skills.js +129 -17
- package/dist/skills.js.map +1 -1
- package/dist/status.d.ts +63 -0
- package/dist/status.d.ts.map +1 -0
- package/dist/status.js +539 -0
- package/dist/status.js.map +1 -0
- package/dist/types.d.ts +151 -13
- package/dist/types.d.ts.map +1 -1
- package/package.json +4 -5
- package/skeleton/README.md +14 -9
- package/skeleton/package.json +2 -1
- package/skill/SKILL.md +20 -16
- package/skill-catalogue/advisor/SKILL.md +100 -11
- package/skill-catalogue/architect/SKILL.md +2 -13
- package/skill-catalogue/bouncer/SKILL.md +2 -13
- package/skill-catalogue/builder/SKILL.md +2 -13
- package/skill-catalogue/butler/SKILL.md +2 -13
- package/skill-catalogue/controller/SKILL.md +2 -13
- package/skill-catalogue/customer/SKILL.md +4 -13
- package/skill-catalogue/designer/SKILL.md +9 -14
- package/skill-catalogue/giver/SKILL.md +2 -13
- package/skill-catalogue/influencer/SKILL.md +2 -13
- package/skill-catalogue/inspector/SKILL.md +2 -13
- package/skill-catalogue/integrator/SKILL.md +2 -13
- package/skill-catalogue/keeper/SKILL.md +2 -13
- package/skill-catalogue/launcher/SKILL.md +20 -16
- package/skill-catalogue/locksmith/SKILL.md +2 -13
- package/skill-catalogue/messenger/SKILL.md +2 -13
- package/skill-catalogue/observer/SKILL.md +2 -13
- package/skill-catalogue/publisher/SKILL.md +11 -17
- package/skill-catalogue/starter/SKILL.md +3 -13
- package/skill-catalogue/strategist/SKILL.md +14 -17
- package/skill-catalogue/writer/SKILL.md +7 -14
- package/src/admission-fixture.ts +572 -0
- package/src/admission.ts +816 -0
- package/src/agents-guide.ts +29 -0
- package/src/apply-command-options.check.ts +27 -0
- package/src/apply-plan-cli.ts +454 -14
- package/src/apply-plan.ts +112 -124
- package/src/apply-step-fixture.ts +236 -0
- package/src/apply-store.ts +584 -0
- package/src/approval-sheet.ts +164 -0
- package/src/body-command.ts +162 -0
- package/src/change-set-contract.ts +937 -0
- package/src/change-set-digest.ts +70 -0
- package/src/check-cli.ts +14 -3
- package/src/cli.ts +90 -22
- package/src/core.ts +973 -275
- package/src/dry-materialize.ts +353 -0
- package/src/generated/contract-schema.generated.ts +520 -0
- package/src/generated/package-scope.generated.ts +10 -0
- package/src/generated/plan-contracts.generated.ts +2840 -0
- package/src/host.ts +10 -0
- package/src/identity.ts +51 -0
- package/src/index.ts +72 -3
- package/src/inventory-adoption.ts +107 -29
- package/src/inventory-choice.ts +172 -0
- package/src/inventory-contract.ts +166 -0
- package/src/key-editor.ts +446 -0
- package/src/ledger-contract.ts +637 -0
- package/src/ledger-trust.ts +267 -0
- package/src/lockfile-invariants.ts +421 -0
- package/src/lockfile-readers.ts +749 -0
- package/src/lockfile-regen.ts +851 -0
- package/src/lockfile-tool-env.ts +131 -0
- package/src/materialize.ts +886 -0
- package/src/observe-repository.ts +1365 -0
- package/src/plan-bundle-setup-fixture.ts +200 -0
- package/src/plan-bundle.ts +964 -0
- package/src/plan-command.ts +509 -0
- package/src/plan-contract.ts +179 -0
- package/src/plan-digest.ts +102 -0
- package/src/plan-rules.ts +188 -0
- package/src/planned-bundle.ts +211 -0
- package/src/product-repository.ts +10 -1
- package/src/provenance-gate.ts +352 -0
- package/src/pull-request-body.ts +261 -0
- package/src/registry-snapshot.ts +534 -0
- package/src/release-age-edit.ts +430 -0
- package/src/root-entries.ts +81 -0
- package/src/setup-template-scripts.ts +571 -0
- package/src/setup-templates.ts +471 -0
- package/src/skills.ts +161 -18
- package/src/status.ts +557 -0
- package/src/types.ts +148 -13
- package/CHANGELOG.md +0 -131
package/dist/core.d.ts
CHANGED
|
@@ -12,11 +12,14 @@ export declare const LEGACY_STATE_DIR_REL = ".clossys";
|
|
|
12
12
|
export declare const LEGACY_WORKSPACE_MARKER_REL: string;
|
|
13
13
|
export declare const LEGACY_WORKSPACE_INVENTORY_REL: string;
|
|
14
14
|
export declare const ADVISOR_PACKAGE = "@clossys/advisor";
|
|
15
|
+
export declare const INTEGRATOR_PACKAGE = "@clossys/integrator";
|
|
15
16
|
export declare const LAUNCHER_PACKAGE = "@clossys/launcher";
|
|
17
|
+
/** The engines a hub pins: each exactly, once, in `devDependencies`, at its live registry version. */
|
|
18
|
+
export declare const HUB_ENGINE_PACKAGES: readonly ["@clossys/advisor", "@clossys/integrator"];
|
|
16
19
|
/** Written at generate time so this package never ships a nested AGENTS.md. */
|
|
17
|
-
export declare const CONSUMER_AGENTS_MD = "# Account workspace\n\nThis folder is the account hub for Foundry packages.\n\nAfter `npx @clossys/launcher`, the
|
|
18
|
-
/**
|
|
19
|
-
export declare const
|
|
20
|
+
export declare const CONSUMER_AGENTS_MD = "# Account workspace\n\nThis folder is the account hub for Foundry packages.\n\nAfter `npx @clossys/launcher`, the `@clossys-*` team is composed in this\nhub. Talk with `@clossys-advisor` and `@clossys-<package>` here. A launcher\nrun writes nothing into a product repository; once a repository is staffed\nin an approved plan, it gets `@clossys-advisor` and the voices of the roles\nstaffed there, with that plan's setup pull request. A missing `@` mention\nis a bug only here in the hub; in a product repository, a role that is not\nstaffed there is expected to be absent. `@clossys-advisor` is the hiring\ncheck.\n\nRun `npx @clossys/launcher` again for hub health and to refresh the voices\nin this hub, not as how you talk to packages.\n\nThe person in this folder is a founder, not an engineer. Speak like a\nperson. Do not dump machine identifiers, JSON, hashes, or grant fields\nunless they ask.\n\nAdvisor is read-only until the sponsor approves a next action.\n";
|
|
21
|
+
/** The hub guidance written while a launcher run still composed the team into checkouts beside the hub; resume refreshes it. */
|
|
22
|
+
export declare const SIBLING_COMPOSING_CONSUMER_AGENTS_MD = "# Account workspace\n\nThis folder is the account hub for Foundry packages.\n\nAfter `npx @clossys/launcher`, the same `@clossys-*` team is composed in\nevery inventoried checkout beside this hub. Talk with `@clossys-advisor` and\n`@clossys-<package>` here or in a product repository. A missing `@` mention\nis not how we signal incompatibility \u2014 `@clossys-advisor` is the hiring check.\n\nRun `npx @clossys/launcher` again for hub health and to refresh voices on\nclones next to the hub, not as how you talk to packages.\n\nThe person in this folder is a founder, not an engineer. Speak like a\nperson. Do not dump machine identifiers, JSON, hashes, or grant fields\nunless they ask.\n\nAdvisor is read-only until the sponsor approves a next action.\n";
|
|
20
23
|
/** Previous generate-time guidance; used to refresh stale hub AGENTS.md on resume. */
|
|
21
24
|
export declare const LEGACY_CONSUMER_AGENTS_MD = "# Account workspace\n\nThis repository is the account hub for Foundry packages. It inventories\nwhere packages are installed and coordinates engagement. It is not a\nproduct application and does not need the whole catalogue installed here.\n\nThe person in this folder is a founder, not an engineer. Speak like a\nperson. Do not dump machine identifiers, JSON, hashes, or grant fields\nunless they ask.\n\nWhen there is a next step, say only:\n\n1. Where we are (one sentence).\n2. What you should do next (one sentence).\n3. What we will not do until you say yes.\n4. Whether anything will be saved to git (usually no).\n\nWait for a plain yes before changing files. \"Approved\" in chat is\npermission for that one step only. It is not a lasting grant and it\ndoes not become a commit unless someone later saves a file.\n\nOpen this folder in your coding agent. Advisor is read-only until you\napprove a next action.\n\nRun `npx @clossys/launcher` again to resume. Public npm reads\nneed no token.\n";
|
|
22
25
|
export declare const CONSUMER_CLAUDE_MD = "@AGENTS.md\n";
|
|
@@ -27,33 +30,71 @@ export declare function parseGitHubRemote(url: string): {
|
|
|
27
30
|
} | null;
|
|
28
31
|
/** True when the marker is a v1 account-hub document. */
|
|
29
32
|
export declare function isHubDocument(value: unknown): value is HubDocument;
|
|
30
|
-
/**
|
|
31
|
-
|
|
33
|
+
/**
|
|
34
|
+
* The inventory document's shape lives in docs/contracts/repository-inventory.json
|
|
35
|
+
* (in the public repository; that exact path does not ship in this
|
|
36
|
+
* package, but this package's build packs and ships its own copy of the
|
|
37
|
+
* contract) and is checked, on every read and write, by
|
|
38
|
+
* `validateInventoryDocument()` through the shared contract checker
|
|
39
|
+
* (./inventory-contract.ts, #1334, #1179).
|
|
40
|
+
*/
|
|
41
|
+
export { validateInventoryDocument } from "./inventory-contract.js";
|
|
42
|
+
export type { InventoryValidation } from "./inventory-contract.js";
|
|
43
|
+
/**
|
|
44
|
+
* Classifies a generated hub inventory (packed template skeleton/clossys/.state/inventory.json; the generated path does not ship) without inventing repositories. Malformed input is "invalid", never silently folded into "empty" (#1334).
|
|
45
|
+
* Pass the file's exact bytes (`WorkspaceHost.readBytes()`), and the hub's owner when it is known, so a bare id and `<owner>/<id>` count as one repository (#1179).
|
|
46
|
+
*/
|
|
47
|
+
export declare function inspectInventory(raw: string | Uint8Array | null, hubOwner?: string): InventoryObservation;
|
|
32
48
|
/** True when the tree already pins Advisor in some bucket, so adopt would not need a new version. */
|
|
33
49
|
export declare function hasAdvisorPin(manifest: unknown): boolean;
|
|
34
|
-
/** Collects GitHub owner, cwd shape, default-hub presence, and the public Advisor pin. */
|
|
35
50
|
/**
|
|
36
51
|
* Reads the public `@clossys/launcher` registry version, used only to grade
|
|
37
52
|
* catalogue-sourced skill staleness in the health report (#1183). A missing
|
|
38
53
|
* or unparseable read leaves staleness ungraded rather than refusing.
|
|
39
54
|
*/
|
|
40
55
|
export declare function readLiveLauncherVersion(host: WorkspaceHost): string | undefined;
|
|
56
|
+
/**
|
|
57
|
+
* Collects GitHub owner, cwd shape, default-hub presence, and the public
|
|
58
|
+
* Advisor and Integrator versions. Default-hub presence means only that
|
|
59
|
+
* `{owner}/workspace` exists on GitHub; its contents (marker, legacy marker,
|
|
60
|
+
* or none) are not observed here but classified after the clone, at apply
|
|
61
|
+
* time (#1585).
|
|
62
|
+
*/
|
|
41
63
|
export declare function observeWorkspace(host: WorkspaceHost): WorkspaceObservation;
|
|
42
64
|
/**
|
|
43
65
|
* Decides create, resume, or adopt from a cwd observation.
|
|
44
66
|
* Appointing means: run this from the GitHub repository that should own the hub.
|
|
45
67
|
*/
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
68
|
+
/**
|
|
69
|
+
* Reads repository ids from a `schemaVersion: 1` inventory document, routed
|
|
70
|
+
* through `validateInventoryDocument` -- the same schema check `--inventory`
|
|
71
|
+
* and `inspectInventory` apply, so a caller here can never end up trusting a
|
|
72
|
+
* document neither of those would have accepted (#1334). Throws, naming the
|
|
73
|
+
* offending field, on anything present but invalid; a missing file is `[]`,
|
|
74
|
+
* not a throw -- an absent inventory is a fact about the hub, not a
|
|
75
|
+
* malformed one. The file is read as bytes; `hubOwner`, when given, makes a
|
|
76
|
+
* bare id and `<hubOwner>/<id>` one repository, so a document listing both
|
|
77
|
+
* is refused.
|
|
78
|
+
*/
|
|
79
|
+
export declare function readInventoryRepositories(host: WorkspaceHost, source: string, label: string, hubOwner?: string): readonly string[];
|
|
80
|
+
export interface PlanWorkspaceOptions {
|
|
81
|
+
/** `--inventory <path>`: a prepared inventory document, appoint only. */
|
|
82
|
+
readonly inventoryPath?: string;
|
|
83
|
+
/** `--repositories`: the repository ids a founder chose on Advisor's repository card (#1179). Appoint or resume of a hub checkout. */
|
|
84
|
+
readonly repositories?: readonly string[];
|
|
85
|
+
/** `--replace-inventory`: explicit approval for `repositories` to replace a stored inventory that lists a different set, or one that fails its contract. */
|
|
86
|
+
readonly replaceInventory?: boolean;
|
|
87
|
+
}
|
|
88
|
+
export declare function planWorkspace(observation: WorkspaceObservation, host: WorkspaceHost, options?: PlanWorkspaceOptions): WorkspaceDecision;
|
|
50
89
|
/**
|
|
51
90
|
* Read-only pin and inventory report. Does not install or uninstall. Scans all
|
|
52
|
-
* four dependency buckets
|
|
53
|
-
*
|
|
54
|
-
*
|
|
91
|
+
* four dependency buckets for both hub engines (Advisor and Integrator);
|
|
92
|
+
* grades each pinned version against that engine's live registry version,
|
|
93
|
+
* when known, marking a pin older than live as a stale-pin finding and a
|
|
94
|
+
* degraded report. `liveIntegratorVersion` is the last parameter so earlier
|
|
95
|
+
* callers keep their argument positions.
|
|
55
96
|
*/
|
|
56
|
-
export declare function reportHubHealth(host: WorkspaceHost, directory: string, liveAdvisorVersion?: string, liveLauncherVersion?: string, retiredThisRun?: readonly string[], migration?: HubHealthReport["migration"]): HubHealthReport;
|
|
97
|
+
export declare function reportHubHealth(host: WorkspaceHost, directory: string, liveAdvisorVersion?: string, liveLauncherVersion?: string, retiredThisRun?: readonly string[], migration?: HubHealthReport["migration"], liveIntegratorVersion?: string): HubHealthReport;
|
|
57
98
|
export declare function formatHubHealth(report: HubHealthReport): string;
|
|
58
99
|
/**
|
|
59
100
|
* Read-only inventory validation: runs `gh repo view --json name` for each
|
|
@@ -61,23 +102,39 @@ export declare function formatHubHealth(report: HubHealthReport): string;
|
|
|
61
102
|
* a note; marks ids whose check fails as unknown. Never mutates the inventory.
|
|
62
103
|
*/
|
|
63
104
|
export declare function checkInventoryEntries(host: WorkspaceHost, directory: string): InventoryValidationReport;
|
|
105
|
+
/** The position a message names instead of a document-sourced inventory id, matching `inventory-choice.ts`'s `listRemovedPositions`. `undefined` only for the stored-inventory-file-itself failure, which names the file by its own constant path instead. */
|
|
106
|
+
export declare function inventoryPositionLabel(inventoryId: string, position: number | undefined): string;
|
|
64
107
|
export interface CloneMissingOutcome {
|
|
108
|
+
/** Internal use only (a `gh repo clone` argument, a caller's own lookup) -- never put directly in a printed message; see `position`. */
|
|
65
109
|
readonly inventoryId: string;
|
|
110
|
+
/** This id's 0-based position in the stored inventory's `repositories` array; what a message names instead of `inventoryId`. `undefined` only for the stored-inventory-file-itself failure. */
|
|
111
|
+
readonly position?: number;
|
|
66
112
|
readonly result: "cloned" | "skipped-other-reason" | "failed";
|
|
67
113
|
readonly note: string;
|
|
68
114
|
}
|
|
69
115
|
/**
|
|
70
116
|
* Explicit, approved action (#1179, the #1045 pattern): clones every
|
|
71
|
-
* inventoried repository that
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
* --clone-missing flag. Reverses the launcher README's own no-clone
|
|
77
|
-
* default for exactly this one approved action.
|
|
117
|
+
* inventoried repository that classifyInventoriedSiblings found not cloned
|
|
118
|
+
* beside the hub, and only those -- every other reason (wrong account,
|
|
119
|
+
* foundry supplier tree, origin mismatch, invalid slug, invalid inventory)
|
|
120
|
+
* is reported as skipped, never attempted, and a checkout already beside
|
|
121
|
+
* the hub is left out. Never called from resume's default path; only from
|
|
122
|
+
* the --clone-missing flag. Reverses the launcher README's own no-clone
|
|
123
|
+
* default for exactly this one approved action. Cloning is not composing:
|
|
124
|
+
* a cloned repository receives its team only once it is staffed in an
|
|
125
|
+
* approved plan, with that plan's setup pull request.
|
|
78
126
|
*/
|
|
79
127
|
export declare function cloneMissingInventoryRepositories(host: WorkspaceHost, hubDirectory: string, hubOwner: string): readonly CloneMissingOutcome[];
|
|
80
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* Applies a create, resume, or adopt plan through the host. Resume refreshes
|
|
130
|
+
* composed skills and stale AGENTS.md guidance. A resume plan that clones
|
|
131
|
+
* (`clone: true`, planned from an empty directory) is classified only after
|
|
132
|
+
* the clone, by `classifyClonedHub`: a marked clone resumes (migrating a
|
|
133
|
+
* legacy marker), an unmarked one is appointed through the adopt path, and
|
|
134
|
+
* every refusal Launcher decides happens before anything is written into the clone (#1585).
|
|
135
|
+
* Every path writes only into the hub checkout, never into an inventoried
|
|
136
|
+
* repository beside it.
|
|
137
|
+
*/
|
|
81
138
|
export declare function applyWorkspacePlan(host: WorkspaceHost, plan: WorkspacePlan, skeletonRoot: string, options?: ApplyWorkspaceOptions): WorkspaceApplyResult;
|
|
82
139
|
export declare function launcherPackageRootFromModule(moduleUrl: string): string;
|
|
83
140
|
export declare function skeletonRootFromModule(moduleUrl: string): string;
|
package/dist/core.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,qBAAqB,
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}
|