@msn-control/liftoff 0.10.1 → 0.10.2

package/dist/artifact-lifecycle.d.ts

@@ -1,4 +1,21 @@
 import type { ProjectProvisioningGroup } from './types.js';
-export declare const managedCoreLogicalNames: readonly ['repository-governance-policy', 'repository-governance-context', 'repository-governance-guide', 'repository-governance-phase-graph', 'repository-governance-compatibility', 'repository-governance-credential-policy-schema', 'liftoff-setup-copilot', 'liftoff-setup-claude', 'repository-governance-copilot-launcher', 'repository-governance-claude-launcher'];
+export declare const managedCoreLogicalNames: readonly ['repository-governance-policy', 'repository-governance-context', 'repository-governance-guide', 'repository-governance-phase-graph', 'repository-governance-compatibility', 'repository-governance-credential-policy-schema', 'liftoff-setup-copilot', 'liftoff-setup-claude'];
 export declare function isManagedCoreLogicalName(logicalName: string): boolean;
+export declare const retiredManagedCoreIdentities: readonly [{
+    readonly logicalName: 'repository-governance-copilot-launcher';
+    readonly category: 'governance';
+    readonly pathParts: readonly ['.github', 'prompts', 'liftoff-repository-governance.prompt.md'];
+    readonly replacementLogicalName: 'liftoff-setup-copilot';
+}, {
+    readonly logicalName: 'repository-governance-claude-launcher';
+    readonly category: 'governance';
+    readonly pathParts: readonly ['.claude', 'commands', 'liftoff-repository-governance.md'];
+    readonly replacementLogicalName: 'liftoff-setup-claude';
+}];
+export type RetiredManagedCoreIdentity = (typeof retiredManagedCoreIdentities)[number];
+export declare const retiredManagedCoreIdentityMap: ReadonlyMap<string, RetiredManagedCoreIdentity>;
+export declare function isRetiredManagedCoreLogicalName(logicalName: string): boolean;
+export declare function isUnknownRetiredManagedCoreAliasLogicalName(logicalName: string): boolean;
+export declare function retiredManagedCoreIdentityFor(logicalName: string): RetiredManagedCoreIdentity | undefined;
+export declare function isRetiredManagedCoreArtifactIdentity(logicalName: string, category: string, pathParts: readonly string[]): boolean;
 export declare function legacyProvisioningGroup(logicalName: string): ProjectProvisioningGroup;

package/dist/artifact-lifecycle.js

@@ -7,14 +7,45 @@ export const managedCoreLogicalNames = [
     'repository-governance-compatibility',
     'repository-governance-credential-policy-schema',
     'liftoff-setup-copilot',
-    'liftoff-setup-claude',
-    'repository-governance-copilot-launcher',
-    'repository-governance-claude-launcher'
+    'liftoff-setup-claude'
 ];
 const managedCoreLogicalNameSet = new Set(managedCoreLogicalNames);
 export function isManagedCoreLogicalName(logicalName) {
     return managedCoreLogicalNameSet.has(logicalName);
 }
+export const retiredManagedCoreIdentities = [
+    {
+        logicalName: 'repository-governance-copilot-launcher',
+        category: 'governance',
+        pathParts: ['.github', 'prompts', 'liftoff-repository-governance.prompt.md'],
+        replacementLogicalName: 'liftoff-setup-copilot'
+    },
+    {
+        logicalName: 'repository-governance-claude-launcher',
+        category: 'governance',
+        pathParts: ['.claude', 'commands', 'liftoff-repository-governance.md'],
+        replacementLogicalName: 'liftoff-setup-claude'
+    }
+];
+export const retiredManagedCoreIdentityMap = new Map(retiredManagedCoreIdentities.map((identity) => [identity.logicalName, identity]));
+const retiredManagedCoreLogicalNameSet = new Set(retiredManagedCoreIdentities.map((identity) => identity.logicalName));
+export function isRetiredManagedCoreLogicalName(logicalName) {
+    return retiredManagedCoreLogicalNameSet.has(logicalName);
+}
+export function isUnknownRetiredManagedCoreAliasLogicalName(logicalName) {
+    return (/^repository-governance(?:-.+)?-launcher$/.test(logicalName) ||
+        logicalName === 'liftoff-repository-governance') &&
+        !isRetiredManagedCoreLogicalName(logicalName);
+}
+export function retiredManagedCoreIdentityFor(logicalName) {
+    return retiredManagedCoreIdentityMap.get(logicalName);
+}
+export function isRetiredManagedCoreArtifactIdentity(logicalName, category, pathParts) {
+    const identity = retiredManagedCoreIdentityFor(logicalName);
+    return identity !== undefined &&
+        category === identity.category &&
+        pathParts.join('\0') === identity.pathParts.join('\0');
+}
 const frontendLogicalNames = new Set([
     'frontend-package',
     'frontend-lock',

package/dist/artifact-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-lifecycle.js","sourceRoot":"","sources":["../src/artifact-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,8BAA8B;IAC9B,+BAA+B;IAC/B,6BAA6B;IAC7B,mCAAmC;IACnC,qCAAqC;IACrC,gDAAgD;IAChD,uBAAuB;IACvB,sBAAsB;IACtB,wCAAwC;IACxC,uCAAuC;CAC/B,CAAC;AAEX,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AAE3E,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,sBAAsB;IACtB,iBAAiB;IACjB,sBAAsB;IACtB,0BAA0B;IAC1B,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,6BAA6B,GAAG,IAAI,GAAG,EAAoC,CAAC;AAClF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,eAAe,WAAW,CAAC,EAAE,EAAW,CAAC;IACvD,6BAA6B,CAAC,GAAG,CAAC,eAAe,WAAW,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAClF,6BAA6B,CAAC,GAAG,CAAC,eAAe,WAAW,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACpF,6BAA6B,CAAC,GAAG,CAAC,YAAY,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAmB;IAEnB,IAAI,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,6BAA6B,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC;AAClE,CAAC"}
+{"version":3,"file":"artifact-lifecycle.js","sourceRoot":"","sources":["../src/artifact-lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/commands.js

@@ -860,7 +860,20 @@ async function migrateCommand(parsed, context) {
     return withUnchangedMigrationSource(sourceRoot, () => executeMigration(parsed, context, sourceRoot));
 }
 function summarizeEntries(entries) {
-    const summary = { new: 0, missing: 0, upgrade: 0, conflict: 0, moved: 0, orphan: 0, refresh: 0, unchanged: 0 };
+    const summary = {
+        new: 0,
+        missing: 0,
+        upgrade: 0,
+        conflict: 0,
+        moved: 0,
+        orphan: 0,
+        retired: 0,
+        retiredRemoved: 0,
+        retiredAbsent: 0,
+        retiredConflict: 0,
+        refresh: 0,
+        unchanged: 0
+    };
     for (const entry of entries) {
         if (entry.status === 'unchanged') {
             if (entry.refreshHash) {
@@ -871,6 +884,20 @@ function summarizeEntries(entries) {
             }
             continue;
         }
+        if (entry.status === 'retired-conflict') {
+            summary.retiredConflict += 1;
+            continue;
+        }
+        if (entry.status === 'retired') {
+            summary.retired += 1;
+            if (entry.destinationOccupied === false) {
+                summary.retiredAbsent += 1;
+            }
+            else {
+                summary.retiredRemoved += 1;
+            }
+            continue;
+        }
         if (entry.status === 'moved' && !entry.cleanMove) {
             summary.conflict += 1;
             continue;
@@ -891,7 +918,10 @@ function entryMarker(entry) {
         case 'moved':
             return entry.cleanMove ? '>' : '!';
         case 'orphan':
+        case 'retired':
             return '-';
+        case 'retired-conflict':
+            return '!';
         default:
             return '~';
     }
@@ -1061,9 +1091,14 @@ async function preflightUpdate(projectRoot, entries, force) {
             entry.status === 'upgrade' ||
             entry.status === 'moved' && (entry.cleanMove === true || force) ||
             entry.status === 'conflict' && force;
+        const deletesDestination = entry.status === 'retired' ||
+            entry.status === 'retired-conflict' && force;
         if (writesDestination) {
             await resolveProjectPath(projectRoot, entry.pathParts);
         }
+        if (deletesDestination) {
+            await resolveProjectPath(projectRoot, entry.pathParts);
+        }
         if (entry.previousPathParts &&
             (entry.status === 'moved' && (entry.cleanMove === true || force) || entry.status === 'conflict' && force)) {
             await resolveProjectPath(projectRoot, entry.previousPathParts);
@@ -1487,6 +1522,7 @@ async function updateCommand(parsed, context) {
             cliVersion: liftoffVersion,
             projectVersion: manifest.liftoffVersion,
             entries: [],
+            removed: [],
             provisioning: [],
             ownershipMigrationPending: false,
             manifestChanges: plannedManifestChanges,
@@ -1540,6 +1576,7 @@ async function updateCommand(parsed, context) {
                 cliVersion: liftoffVersion,
                 projectVersion: manifest.liftoffVersion,
                 written: [],
+                removed: [],
                 skipped: [],
                 provisioning: [],
                 ownershipMigrationPending,
@@ -1573,6 +1610,9 @@ async function updateCommand(parsed, context) {
                     status: entry.status,
                     path: manifestDisplayPath(entry.pathParts),
                     previousPath: entry.previousPathParts ? manifestDisplayPath(entry.previousPathParts) : undefined,
+                    fileDeleted: entry.status === 'retired' || entry.status === 'retired-conflict'
+                        ? entry.destinationOccupied !== false
+                        : undefined,
                     reason: entry.reason
                 })),
                 provisioning: provisioningJson(provisioningPlans),
@@ -1635,11 +1675,12 @@ async function updateCommand(parsed, context) {
                 : group.entries.filter((entry) => entry.status === 'create').length), 0) +
             (manifestRewritePending ? 1 : 0) +
             stateMigration.mutations.length;
-        presentation.status('warning', 'Liftoff core maintenance available', `${toWrite} to write, ${summary.conflict} core conflict(s), ${summary.orphan} core orphan(s), ${summary.unchanged} core unchanged`);
-        if (toWrite > 0) {
+        const toRetire = summary.retired;
+        presentation.status('warning', 'Liftoff core maintenance available', `${toWrite} to write, ${toRetire} retired alias ownership record(s) to remove (${summary.retiredRemoved} file deletion(s)), ${summary.conflict + summary.retiredConflict} core conflict(s), ${summary.orphan} core orphan(s), ${summary.unchanged} core unchanged`);
+        if (toWrite > 0 || toRetire > 0) {
             presentation.command('liftoff update');
         }
-        if (summary.conflict > 0) {
+        if (summary.conflict > 0 || summary.retiredConflict > 0) {
             presentation.command('liftoff update --force');
         }
         return 2;
@@ -1658,6 +1699,7 @@ async function updateCommand(parsed, context) {
     await preflightUpdate(projectRoot, entries, force);
     maybeInjectUpdateFailure(context.env, 'after-preflight');
     const written = [];
+    const retired = [];
     const skipped = [];
     const mutations = [];
     for (const entry of entries) {
@@ -1688,6 +1730,19 @@ async function updateCommand(parsed, context) {
                     skipped.push(entry);
                 }
                 break;
+            case 'retired':
+                mutations.push({ type: 'delete', pathParts: entry.pathParts });
+                retired.push(entry);
+                break;
+            case 'retired-conflict':
+                if (force) {
+                    mutations.push({ type: 'delete', pathParts: entry.pathParts });
+                    retired.push(entry);
+                }
+                else {
+                    skipped.push(entry);
+                }
+                break;
             case 'conflict':
                 if (force) {
                     mutations.push({
@@ -1732,6 +1787,7 @@ async function updateCommand(parsed, context) {
     const hasUnrecordedGovernanceConflict = skipped.some((entry) => entry.status === 'conflict' &&
         entry.rendered?.category === 'governance' &&
         !oldByName.has(entry.logicalName));
+    const hasProtectedRetiredAlias = skipped.some((entry) => entry.status === 'retired-conflict');
     const nextProjectArtifacts = appendProvisionedProjectArtifacts(manifest.projectArtifacts, provisioningPlans);
     const nextManifest = buildManifest(renderPlan, render.filter((artifact) => artifact.logicalName !== 'manifest'), {
         frameworkState: manifest.framework.state,
@@ -1746,7 +1802,7 @@ async function updateCommand(parsed, context) {
     else {
         delete nextManifest.project.defaultAgent;
     }
-    if (hasUnrecordedGovernanceConflict &&
+    if ((hasUnrecordedGovernanceConflict || hasProtectedRetiredAlias) &&
         nextManifest.governance.profile !== 'none') {
         nextManifest.governance.state = 'handoff-partial';
     }
@@ -1769,6 +1825,14 @@ async function updateCommand(parsed, context) {
             }
             nextManifest.managedArtifacts.push(previous);
         }
+        if (entry.status === 'retired-conflict' && !force) {
+            const previous = oldByName.get(entry.logicalName);
+            if (plan.governanceProfile.id === 'none' &&
+                previous.category === 'governance') {
+                continue;
+            }
+            nextManifest.managedArtifacts.push(previous);
+        }
     }
     mutations.push({
         type: 'write',
@@ -1791,7 +1855,7 @@ async function updateCommand(parsed, context) {
             schemaVersion: 2,
             mode: 'apply',
             scope: 'managed-core',
-            status: blockedProvisioning.length > 0
+            status: blockedProvisioning.length > 0 || skipped.length > 0
                 ? 'partial'
                 : reconciliation.status === 'reconciliation-required'
                     ? 'reconciliation-required'
@@ -1799,8 +1863,24 @@ async function updateCommand(parsed, context) {
             cliVersion: liftoffVersion,
             projectVersion: manifest.liftoffVersion,
             written: written.map((entry) => manifestDisplayPath(entry.pathParts)),
+            removed: retired.map((entry) => ({
+                logicalName: entry.logicalName,
+                status: entry.status === 'retired-conflict'
+                    ? 'force-retired'
+                    : entry.destinationOccupied === false
+                        ? 'retired-absent'
+                        : 'retired',
+                path: manifestDisplayPath(entry.pathParts),
+                fileDeleted: entry.destinationOccupied !== false,
+                reason: entry.reason
+            })),
             stateWritten: stateMigration.mutations.map((mutation) => manifestDisplayPath(mutation.pathParts)),
-            skipped: skipped.map((entry) => ({ path: manifestDisplayPath(entry.pathParts), reason: entry.reason })),
+            skipped: skipped.map((entry) => ({
+                logicalName: entry.logicalName,
+                status: entry.status,
+                path: manifestDisplayPath(entry.pathParts),
+                reason: entry.reason
+            })),
             provisioning: provisioningJson(provisioningPlans),
             ownershipMigrationPending,
             manifestChanges: manifestChanges(manifest, nextManifest),
@@ -1816,6 +1896,14 @@ async function updateCommand(parsed, context) {
     if (written.length > 0) {
         presentation.bullets('Applied Liftoff core changes', written.map((entry) => `wrote ${entryDisplay(entry)}`));
     }
+    const retiredDeleted = retired.filter((entry) => entry.destinationOccupied !== false);
+    const retiredAbsent = retired.filter((entry) => entry.destinationOccupied === false);
+    if (retiredDeleted.length > 0) {
+        presentation.bullets('Removed retired Liftoff aliases', retiredDeleted.map((entry) => `removed ${entryDisplay(entry)}  ${entry.reason}`));
+    }
+    if (retiredAbsent.length > 0) {
+        presentation.bullets('Retired absent Liftoff alias ownership', retiredAbsent.map((entry) => `removed manifest ownership for ${entryDisplay(entry)}  ${entry.reason}`));
+    }
     if (stateMigration.status === 'migrate') {
         presentation.bullets('Migrated activation state', stateMigration.mutations.map((mutation) => `wrote ${manifestDisplayPath(mutation.pathParts)}; evidence bytes preserved`));
     }
@@ -1828,7 +1916,9 @@ async function updateCommand(parsed, context) {
             .map((entry) => `${group.group}: preserved ${manifestDisplayPath(entry.rendered.pathParts)}; --force cannot overwrite project-owned bytes`)));
     }
     if (skipped.length > 0) {
-        presentation.bullets('Skipped Liftoff core conflicts', skipped.map((entry) => `skipped ${entryDisplay(entry)}  ${entry.reason}${force ? '' : ' (use --force to overwrite)'}`));
+        presentation.bullets('Skipped Liftoff core conflicts', skipped.map((entry) => entry.status === 'retired-conflict'
+            ? `protected retired alias ${entryDisplay(entry)}  ${entry.reason}${force ? '' : ' (delete it manually or use --force to remove)'}`
+            : `skipped ${entryDisplay(entry)}  ${entry.reason}${force ? '' : ' (use --force to overwrite)'}`));
     }
     const orphans = entries.filter((entry) => entry.status === 'orphan');
     if (orphans.length > 0) {
@@ -1843,6 +1933,8 @@ async function updateCommand(parsed, context) {
     }
     presentation.completion('Updated project', [
         `${written.length} core written`,
+        `${retired.length} retired ownership removed`,
+        `${retiredDeleted.length} retired file deleted`,
         `${provisioned.length} project provisioned`,
         ...(blockedProvisioning.length > 0
             ? [`${blockedProvisioning.length} provisioning group(s) blocked`]