@clossys/launcher 0.1.2 → 0.3.0

package/dist/core.d.ts

@@ -1,10 +1,24 @@
-import type { HubDocument, HubHealthReport, InventoryObservation, InventoryValidationReport, WorkspaceApplyResult, WorkspaceDecision, WorkspaceHost, WorkspaceObservation, WorkspacePlan } from "./types.js";
+import type { ApplyWorkspaceOptions, HubDocument, HubHealthReport, InventoryObservation, InventoryValidationReport, WorkspaceApplyResult, WorkspaceDecision, WorkspaceHost, WorkspaceObservation, WorkspacePlan } from "./types.js";
 export declare const DEFAULT_REPOSITORY_NAME = "workspace";
-export declare const WORKSPACE_MARKER_REL = ".clossys/workspace.json";
-export declare const WORKSPACE_INVENTORY_REL = ".clossys/inventory.json";
+/** The one visible, per-repository Clossys folder (#1171). Every role's output lives under it. */
+export declare const CLOSSYS_DIR_REL = "clossys";
+/** Machine files only: hub marker, inventory, skills manifest. Visible (not dot-hidden) so it is easy to find, but not a place a person edits by hand. */
+export declare const STATE_DIR_REL: string;
+export declare const WORKSPACE_MARKER_REL: string;
+export declare const WORKSPACE_INVENTORY_REL: string;
+export declare const CLOSSYS_README_REL: string;
+/** Pre-#1171 machine-state directory. Resume migrates it automatically; see `locateHub`. */
+export declare const LEGACY_STATE_DIR_REL = ".clossys";
+export declare const LEGACY_WORKSPACE_MARKER_REL: string;
+export declare const LEGACY_WORKSPACE_INVENTORY_REL: string;
 export declare const ADVISOR_PACKAGE = "@clossys/advisor";
+export declare const LAUNCHER_PACKAGE = "@clossys/launcher";
 /** Written at generate time so this package never ships a nested AGENTS.md. */
-export declare const 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\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";
+export declare const 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";
+/** Canned guidance for inventoried product checkouts (not the hub). */
+export declare const SISTER_CONSUMER_AGENTS_MD = "# Product repository\n\nThis repository is part of the same account engagement. The same\n`@clossys-<package>` team is here for intro and questions;\n`@clossys-advisor` decides hiring and compatibility. This folder is not the\nhub \u2014 engines are hired per repository, not dumped here.\n";
+/** Previous generate-time guidance; used to refresh stale hub AGENTS.md on resume. */
+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";
 export declare const CONSUMER_CLAUDE_MD = "@AGENTS.md\n";
 /** Parses a GitHub git remote. Any other host is rejected. */
 export declare function parseGitHubRemote(url: string): {
@@ -13,12 +27,23 @@ export declare function parseGitHubRemote(url: string): {
 } | null;
 /** True when the marker is a v1 account-hub document. */
 export declare function isHubDocument(value: unknown): value is HubDocument;
-/** Classifies a generated hub inventory (packed template skeleton/.clossys/inventory.json; the generated path does not ship) without inventing repositories. */
+/** Classifies a generated hub inventory (packed template skeleton/clossys/.state/inventory.json; the generated path does not ship) without inventing repositories. */
 export declare function inspectInventory(raw: string | null): InventoryObservation;
 /** True when the tree already pins Advisor in some bucket, so adopt would not need a new version. */
 export declare function hasAdvisorPin(manifest: unknown): boolean;
 /** Collects GitHub owner, cwd shape, default-hub presence, and the public Advisor pin. */
+/**
+ * Reads the public `@clossys/launcher` registry version, used only to grade
+ * catalogue-sourced skill staleness in the health report (#1183). A missing
+ * or unparseable read leaves staleness ungraded rather than refusing.
+ */
+export declare function readLiveLauncherVersion(host: WorkspaceHost): string | undefined;
 export declare function observeWorkspace(host: WorkspaceHost): WorkspaceObservation;
+/**
+ * Decides create, resume, or adopt from a cwd observation.
+ * Appointing means: run this from the GitHub repository that should own the hub.
+ */
+export declare function readInventoryRepositories(host: WorkspaceHost, source: string, label: string): readonly string[];
 export declare function planWorkspace(observation: WorkspaceObservation, host: WorkspaceHost, options?: {
     inventoryPath?: string;
 }): WorkspaceDecision;
@@ -28,7 +53,7 @@ export declare function planWorkspace(observation: WorkspaceObservation, host: W
  * registry version, marking a pin older than live as a stale-pin finding and a
  * degraded report.
  */
-export declare function reportHubHealth(host: WorkspaceHost, directory: string, liveAdvisorVersion?: string): HubHealthReport;
+export declare function reportHubHealth(host: WorkspaceHost, directory: string, liveAdvisorVersion?: string, liveLauncherVersion?: string, retiredThisRun?: readonly string[], migration?: HubHealthReport["migration"]): HubHealthReport;
 export declare function formatHubHealth(report: HubHealthReport): string;
 /**
  * Read-only inventory validation: runs `gh repo view --json name` for each
@@ -36,7 +61,24 @@ export declare function formatHubHealth(report: HubHealthReport): string;
  * a note; marks ids whose check fails as unknown. Never mutates the inventory.
  */
 export declare function checkInventoryEntries(host: WorkspaceHost, directory: string): InventoryValidationReport;
-/** Applies a create, resume, or adopt plan through the host. Resume does not write. */
-export declare function applyWorkspacePlan(host: WorkspaceHost, plan: WorkspacePlan, skeletonRoot: string): WorkspaceApplyResult;
+export interface CloneMissingOutcome {
+    readonly inventoryId: string;
+    readonly result: "cloned" | "skipped-other-reason" | "failed";
+    readonly note: string;
+}
+/**
+ * Explicit, approved action (#1179, the #1045 pattern): clones every
+ * inventoried repository that resolveSisterCloneTargets's own skip pass
+ * identified as "just needs a clone" (CLONE_NOT_BESIDE_HUB_NOTE), and only
+ * those -- every other skip reason (wrong account, foundry supplier tree,
+ * origin mismatch, invalid slug) is left exactly as skipped, never
+ * attempted. Never called from resume's default path; only from the
+ * --clone-missing flag. Reverses the launcher README's own no-clone
+ * default for exactly this one approved action.
+ */
+export declare function cloneMissingInventoryRepositories(host: WorkspaceHost, hubDirectory: string, hubOwner: string): readonly CloneMissingOutcome[];
+/** Applies a create, resume, or adopt plan through the host. Resume refreshes composed skills and stale AGENTS.md guidance. */
+export declare function applyWorkspacePlan(host: WorkspaceHost, plan: WorkspacePlan, skeletonRoot: string, options?: ApplyWorkspaceOptions): WorkspaceApplyResult;
+export declare function launcherPackageRootFromModule(moduleUrl: string): string;
 export declare function skeletonRootFromModule(moduleUrl: string): string;
 //# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,WAAW,EACX,eAAe,EACf,oBAAoB,EAEpB,yBAAyB,EAEzB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,aAAa,EAGd,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,uBAAuB,cAAc,CAAC;AACnD,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAC9D,eAAO,MAAM,uBAAuB,4BAA4B,CAAC;AACjE,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAmBlD,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,waAW9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,iBAC9B,CAAC;AAoBF,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB3F;AA8BD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CASlE;AAaD,gKAAgK;AAChK,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB,CAYzE;AAkCD,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAGxD;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CAiE1E;AAwFD,wBAAgB,aAAa,CAC3B,WAAW,EAAE,oBAAoB,EACjC,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,iBAAiB,CAgFnB;AAyJD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe,CA0CpH;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyB/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,yBAAyB,CA4BvG;AAgBD,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,oBAAoB,CAsCvH;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhE"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}