pumuki 6.3.113 → 6.3.115

package/integrations/lifecycle/bootstrapManifest.ts

@@ -1,248 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { getPumukiHooksStatus, resolvePumukiHooksDirectory } from './hookManager'
-import { LifecycleGitService, type ILifecycleGitService } from './gitService'
-import {
-  readGovernanceObservationSnapshot,
-  type GovernanceContractSurface,
-  type GovernanceObservationSnapshot,
-} from './governanceObservationSnapshot'
-import { readGovernanceNextAction, type GovernanceNextActionSummary } from './governanceNextAction'
-import { getCurrentPumukiPackageName, getCurrentPumukiVersion } from './packageInfo'
-import { readLifecycleExperimentalFeaturesSnapshot } from './experimentalFeaturesSnapshot'
-import { readLifecyclePolicyValidationSnapshot } from './policyValidationSnapshot'
-import { readLifecycleState } from './state'
-
-export const BOOTSTRAP_MANIFEST_RELATIVE_PATH = '.pumuki/bootstrap-manifest.json'
-
-type AdapterCommandContract = {
-  path: string
-  present: boolean
-  hooks: {
-    pre_write?: string
-    pre_commit?: string
-    pre_push?: string
-    ci?: string
-  }
-  mcp: {
-    enterprise?: string
-    evidence?: string
-  }
-}
-
-export type LifecycleBootstrapManifest = {
-  schema_version: '1'
-  repo_root: string
-  package: {
-    name: string
-    version: string
-  }
-  lifecycle: {
-    installed: boolean
-    version: string | null
-    installed_at: string | null
-    managed_hooks: ReadonlyArray<string>
-    openspec_managed_artifacts: ReadonlyArray<string>
-  }
-  hooks_directory: {
-    path: string
-    source: 'git-rev-parse' | 'git-config' | 'default'
-  }
-  hook_status: Record<string, { managed_block_present: boolean; exists: boolean }>
-  contract_surface: GovernanceContractSurface
-  governance: {
-    effective: GovernanceObservationSnapshot['governance_effective']
-    attention_codes: ReadonlyArray<string>
-    next_action: GovernanceNextActionSummary
-    bootstrap_hints: ReadonlyArray<string>
-  }
-  sdd: {
-    effective_mode: GovernanceObservationSnapshot['sdd']['effective_mode']
-    experimental_source: string
-    session_active: boolean
-    session_valid: boolean
-    change_id: string | null
-  }
-  policy_strict: GovernanceObservationSnapshot['policy_strict']
-  git: GovernanceObservationSnapshot['git']
-  adapter: AdapterCommandContract
-}
-
-export type LifecycleBootstrapManifestWriteResult = {
-  path: string
-  changed: boolean
-  manifest: LifecycleBootstrapManifest
-}
-
-const isRecord = (value: unknown): value is Record<string, unknown> =>
-  typeof value === 'object' && value !== null && !Array.isArray(value)
-
-const readOptionalCommand = (source: unknown): string | undefined => {
-  if (!isRecord(source)) {
-    return undefined
-  }
-  const command = source.command
-  return typeof command === 'string' && command.trim().length > 0 ? command.trim() : undefined
-}
-
-const readAdapterCommandContract = (repoRoot: string): AdapterCommandContract => {
-  const path = join(repoRoot, '.pumuki', 'adapter.json')
-  if (!existsSync(path)) {
-    return {
-      path: BOOTSTRAP_MANIFEST_RELATIVE_PATH.replace('bootstrap-manifest.json', 'adapter.json'),
-      present: false,
-      hooks: {},
-      mcp: {},
-    }
-  }
-
-  try {
-    const parsed = JSON.parse(readFileSync(path, 'utf8')) as unknown
-    const hooks = isRecord(parsed) && isRecord(parsed.hooks) ? parsed.hooks : {}
-    const mcp = isRecord(parsed) && isRecord(parsed.mcp) ? parsed.mcp : {}
-    return {
-      path: '.pumuki/adapter.json',
-      present: true,
-      hooks: {
-        pre_write: readOptionalCommand(isRecord(hooks) ? hooks.pre_write : undefined),
-        pre_commit: readOptionalCommand(isRecord(hooks) ? hooks.pre_commit : undefined),
-        pre_push: readOptionalCommand(isRecord(hooks) ? hooks.pre_push : undefined),
-        ci: readOptionalCommand(isRecord(hooks) ? hooks.ci : undefined),
-      },
-      mcp: {
-        enterprise: readOptionalCommand(isRecord(mcp) ? mcp.enterprise : undefined),
-        evidence: readOptionalCommand(isRecord(mcp) ? mcp.evidence : undefined),
-      },
-    }
-  } catch {
-    return {
-      path: '.pumuki/adapter.json',
-      present: false,
-      hooks: {},
-      mcp: {},
-    }
-  }
-}
-
-const parseManagedHooks = (raw?: string): string[] => {
-  if (typeof raw !== 'string' || raw.trim().length === 0) {
-    return []
-  }
-  return raw
-    .split(',')
-    .map((value) => value.trim())
-    .filter((value) => value.length > 0)
-}
-
-const parseManagedArtifacts = (raw?: string): string[] => {
-  if (typeof raw !== 'string' || raw.trim().length === 0) {
-    return []
-  }
-  return raw
-    .split(',')
-    .map((value) => value.trim())
-    .filter((value) => value.length > 0)
-}
-
-const toHookStatusSummary = (
-  hookStatus: ReturnType<typeof getPumukiHooksStatus>
-): Record<string, { managed_block_present: boolean; exists: boolean }> =>
-  Object.fromEntries(
-    Object.entries(hookStatus).map(([hook, entry]) => [
-      hook,
-      {
-        managed_block_present: entry.managedBlockPresent,
-        exists: entry.exists,
-      },
-    ])
-  )
-
-export const buildLifecycleBootstrapManifest = (params: {
-  repoRoot: string
-  git?: ILifecycleGitService
-}): LifecycleBootstrapManifest => {
-  const git = params.git ?? new LifecycleGitService()
-  const repoRoot = git.resolveRepoRoot(params.repoRoot)
-  const lifecycleState = readLifecycleState(git, repoRoot)
-  const experimentalFeatures = readLifecycleExperimentalFeaturesSnapshot()
-  const policyValidation = readLifecyclePolicyValidationSnapshot(repoRoot)
-  const governanceObservation = readGovernanceObservationSnapshot({
-    repoRoot,
-    experimentalFeatures,
-    policyValidation,
-    git,
-  })
-  const governanceNextAction = readGovernanceNextAction({
-    repoRoot,
-    stage: governanceObservation.evidence.snapshot_stage ?? 'PRE_WRITE',
-    governanceObservation,
-  })
-  const hooksDirectory = resolvePumukiHooksDirectory(repoRoot)
-  const hookStatus = getPumukiHooksStatus(repoRoot)
-  const adapter = readAdapterCommandContract(repoRoot)
-
-  return {
-    schema_version: '1',
-    repo_root: repoRoot,
-    package: {
-      name: getCurrentPumukiPackageName(),
-      version: getCurrentPumukiVersion({ repoRoot }),
-    },
-    lifecycle: {
-      installed: lifecycleState.installed === 'true',
-      version: typeof lifecycleState.version === 'string' && lifecycleState.version.length > 0
-        ? lifecycleState.version
-        : null,
-      installed_at:
-        typeof lifecycleState.installedAt === 'string' && lifecycleState.installedAt.length > 0
-          ? lifecycleState.installedAt
-          : null,
-      managed_hooks: parseManagedHooks(lifecycleState.hooks),
-      openspec_managed_artifacts: parseManagedArtifacts(lifecycleState.openSpecManagedArtifacts),
-    },
-    hooks_directory: hooksDirectory,
-    hook_status: toHookStatusSummary(hookStatus),
-    contract_surface: governanceObservation.contract_surface,
-    governance: {
-      effective: governanceObservation.governance_effective,
-      attention_codes: governanceObservation.attention_codes,
-      next_action: governanceNextAction,
-      bootstrap_hints: governanceObservation.agent_bootstrap_hints,
-    },
-    sdd: {
-      effective_mode: governanceObservation.sdd.effective_mode,
-      experimental_source: governanceObservation.sdd.experimental_source,
-      session_active: governanceObservation.sdd_session.active,
-      session_valid: governanceObservation.sdd_session.valid,
-      change_id: governanceObservation.sdd_session.change_id,
-    },
-    policy_strict: governanceObservation.policy_strict,
-    git: governanceObservation.git,
-    adapter,
-  }
-}
-
-const serializeManifest = (manifest: LifecycleBootstrapManifest): string =>
-  `${JSON.stringify(manifest, null, 2)}\n`
-
-export const writeLifecycleBootstrapManifest = (params: {
-  repoRoot: string
-  git?: ILifecycleGitService
-}): LifecycleBootstrapManifestWriteResult => {
-  const git = params.git ?? new LifecycleGitService()
-  const repoRoot = git.resolveRepoRoot(params.repoRoot)
-  const path = join(repoRoot, BOOTSTRAP_MANIFEST_RELATIVE_PATH)
-  const manifest = buildLifecycleBootstrapManifest({ repoRoot, git })
-  const nextContents = serializeManifest(manifest)
-  const currentContents = existsSync(path) ? readFileSync(path, 'utf8') : ''
-  const changed = currentContents !== nextContents
-  if (changed) {
-    mkdirSync(dirname(path), { recursive: true })
-    writeFileSync(path, nextContents, 'utf8')
-  }
-  return {
-    path,
-    changed,
-    manifest,
-  }
-}

package/integrations/lifecycle/cliGovernanceConsole.ts

@@ -1,69 +0,0 @@
-import type { LifecycleExperimentalFeaturesSnapshot } from './experimentalFeaturesSnapshot';
-import type { GovernanceNextActionSummary } from './governanceNextAction';
-import { buildGovernanceNextActionSummaryLines } from './governanceNextAction';
-import type { GovernanceObservationSnapshot } from './governanceObservationSnapshot';
-import { buildGovernanceObservationSummaryLines } from './governanceObservationSnapshot';
-import { writeInfo } from './cliOutputs';
-import type { LifecyclePolicyValidationSnapshot } from './policyValidationSnapshot';
-
-export type GovernanceConsoleSnapshot = {
-  governanceObservation: GovernanceObservationSnapshot;
-  governanceNextAction: GovernanceNextActionSummary;
-  policyValidation: LifecyclePolicyValidationSnapshot;
-  experimentalFeatures: LifecycleExperimentalFeaturesSnapshot;
-};
-
-const GOVERNANCE_CONSOLE_FEATURE_ORDER = [
-  'analytics',
-  'heuristics',
-  'learning_context',
-  'mcp_enterprise',
-  'operational_memory',
-  'pre_write',
-  'saas_ingestion',
-  'sdd',
-] as const;
-
-const buildGovernancePolicySummaryLine = (
-  policyValidation: LifecyclePolicyValidationSnapshot
-): string =>
-  `Policy-as-code: PRE_WRITE=${policyValidation.stages.PRE_WRITE.validationCode ?? 'n/a'} strict=${policyValidation.stages.PRE_WRITE.strict ? 'yes' : 'no'} ` +
-  `PRE_COMMIT=${policyValidation.stages.PRE_COMMIT.validationCode ?? 'n/a'} strict=${policyValidation.stages.PRE_COMMIT.strict ? 'yes' : 'no'} ` +
-  `PRE_PUSH=${policyValidation.stages.PRE_PUSH.validationCode ?? 'n/a'} strict=${policyValidation.stages.PRE_PUSH.strict ? 'yes' : 'no'} ` +
-  `CI=${policyValidation.stages.CI.validationCode ?? 'n/a'} strict=${policyValidation.stages.CI.strict ? 'yes' : 'no'}`;
-
-const buildGovernanceExperimentalSummaryLines = (
-  experimentalFeatures: LifecycleExperimentalFeaturesSnapshot
-): string[] =>
-  GOVERNANCE_CONSOLE_FEATURE_ORDER.map((featureKey) => {
-    const feature = experimentalFeatures.features[featureKey];
-    return `Experimental: ${featureKey.toUpperCase()}=${feature.mode} source=${feature.source} layer=${feature.layer} blocking=${feature.blocking ? 'yes' : 'no'} env=${feature.activationVariable}`;
-  });
-
-export const buildGovernanceConsoleSummaryLines = (
-  snapshot: GovernanceConsoleSnapshot
-): string[] => {
-  const lines = ['Governance truth:'];
-  for (const line of buildGovernanceObservationSummaryLines(snapshot.governanceObservation)) {
-    lines.push(`  ${line}`);
-  }
-  for (const hint of snapshot.governanceObservation.evidence.human_summary_preview) {
-    lines.push(`  Evidence hint: ${hint}`);
-  }
-  lines.push('Governance next action:');
-  for (const line of buildGovernanceNextActionSummaryLines(snapshot.governanceNextAction)) {
-    lines.push(`  ${line}`);
-  }
-  lines.push(buildGovernancePolicySummaryLine(snapshot.policyValidation));
-  lines.push(...buildGovernanceExperimentalSummaryLines(snapshot.experimentalFeatures));
-  return lines;
-};
-
-export const printGovernanceConsoleHuman = (
-  snapshot: GovernanceConsoleSnapshot
-): void => {
-  writeInfo('[pumuki] governance console (S1 / shared status-doctor baseline):');
-  for (const line of buildGovernanceConsoleSummaryLines(snapshot)) {
-    writeInfo(`[pumuki]   ${line}`);
-  }
-};

package/integrations/lifecycle/governanceNextAction.ts

@@ -1,171 +0,0 @@
-import type { AiGateStage } from '../gate/evaluateAiGate';
-import { resolveGovernanceCatalogAction } from '../gate/governanceActionCatalog';
-import type { GovernanceObservationSnapshot } from './governanceObservationSnapshot';
-import { writeInfo } from './cliOutputs';
-
-export type GovernanceNextActionSummary = {
-  stage: AiGateStage;
-  phase: 'GREEN' | 'RED';
-  action: 'proceed' | 'ask';
-  confidence_pct: number;
-  reason_code: string;
-  instruction: string;
-  message: string;
-  next_action: {
-    kind: 'info' | 'run_command';
-    message: string;
-    command?: string;
-  };
-};
-
-export type GovernanceNextActionReader = (params: {
-  repoRoot: string;
-  stage?: AiGateStage;
-  governanceObservation: GovernanceObservationSnapshot;
-}) => GovernanceNextActionSummary;
-
-const POLICY_ATTENTION_CODE_BY_STAGE: Record<AiGateStage, string> = {
-  PRE_WRITE: 'POLICY_PRE_WRITE_NOT_STRICT',
-  PRE_COMMIT: 'POLICY_PRE_COMMIT_NOT_STRICT',
-  PRE_PUSH: 'POLICY_PRE_PUSH_NOT_STRICT',
-  CI: 'POLICY_CI_NOT_STRICT',
-};
-
-const resolveBlockedAction = (
-  snapshot: GovernanceObservationSnapshot,
-  stage: AiGateStage
-): GovernanceNextActionSummary => {
-  if (snapshot.attention_codes.includes('EVIDENCE_INVALID_OR_CHAIN')) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 80,
-      ...resolveGovernanceCatalogAction({ code: 'EVIDENCE_INVALID_OR_CHAIN', stage }),
-      message: 'La evidencia actual no es fiable; detén la ejecución automática hasta regenerarla.',
-    };
-  }
-  if (
-    snapshot.attention_codes.includes('AI_GATE_BLOCKED')
-    || snapshot.attention_codes.includes('EVIDENCE_SNAPSHOT_BLOCK')
-  ) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 75,
-      ...resolveGovernanceCatalogAction({ code: 'AI_GATE_BLOCKED', stage }),
-      message: 'El gate efectivo sigue bloqueado; Pumuki no debe marcar verde ni dejar continuar.',
-    };
-  }
-  if (snapshot.attention_codes.includes('SDD_SESSION_INVALID_OR_EXPIRED')) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 70,
-      ...resolveGovernanceCatalogAction({ code: 'SDD_SESSION_INVALID_OR_EXPIRED', stage }),
-      message: 'Hay una sesión SDD activa pero inválida; eso rompe el loop documental esperado.',
-    };
-  }
-  if (snapshot.attention_codes.includes('GITFLOW_PROTECTED_BRANCH_CONTEXT')) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 65,
-      ...resolveGovernanceCatalogAction({ code: 'GITFLOW_PROTECTED_BRANCH_CONTEXT', stage }),
-      message: 'El contexto actual cae sobre una rama protegida; el flujo enterprise no debe continuar ahí.',
-    };
-  }
-  if (
-    snapshot.attention_codes.includes(POLICY_ATTENTION_CODE_BY_STAGE[stage])
-    || snapshot.enterprise_warn_as_block_env
-  ) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 60,
-      ...resolveGovernanceCatalogAction({ code: 'POLICY_STAGE_NOT_STRICT', stage }),
-      message: 'La política efectiva todavía no es estricta en todos los stages requeridos.',
-    };
-  }
-  if (!snapshot.contract_surface.skills_lock_json || !snapshot.contract_surface.skills_sources_json) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 55,
-      ...resolveGovernanceCatalogAction({ code: 'SKILLS_CONTRACT_SURFACE_INCOMPLETE', stage }),
-      message: 'El contrato de skills todavía no está completamente materializado en el repo.',
-    };
-  }
-  if (!snapshot.contract_surface.pumuki_adapter_json) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 50,
-      ...resolveGovernanceCatalogAction({ code: 'ADAPTER_WIRING_MISSING', stage }),
-      message: 'La línea base Git puede operar, pero el wiring adaptador aún no está materializado.',
-    };
-  }
-  if (snapshot.attention_codes.includes('EVIDENCE_SNAPSHOT_WARN')) {
-    return {
-      stage,
-      phase: 'RED',
-      action: 'ask',
-      confidence_pct: 50,
-      ...resolveGovernanceCatalogAction({ code: 'EVIDENCE_SNAPSHOT_WARN', stage }),
-      message: 'La evidencia está en WARN; no conviene tratar el repo como completamente verde.',
-    };
-  }
-  return {
-    stage,
-    phase: 'RED',
-    action: 'ask',
-    confidence_pct: 40,
-    ...resolveGovernanceCatalogAction({ code: 'GOVERNANCE_ATTENTION', stage }),
-    message: 'Todavía hay señales de governance no resueltas.',
-  };
-};
-
-export const readGovernanceNextAction: GovernanceNextActionReader = (params) => {
-  const stage = params.stage ?? 'PRE_WRITE';
-  const snapshot = params.governanceObservation;
-  if (snapshot.governance_effective === 'green') {
-    return {
-      stage,
-      phase: 'GREEN',
-      action: 'proceed',
-      confidence_pct: 90,
-      ...resolveGovernanceCatalogAction({ code: 'READY', stage }),
-      message: 'Governance efectiva en verde: continúa con la implementación mínima.',
-    };
-  }
-  return resolveBlockedAction(snapshot, stage);
-};
-
-export const buildGovernanceNextActionSummaryLines = (
-  snapshot: GovernanceNextActionSummary
-): string[] => {
-  const lines = [
-    `Next action: stage=${snapshot.stage} phase=${snapshot.phase} action=${snapshot.action} confidence=${snapshot.confidence_pct}% reason=${snapshot.reason_code}`,
-    `Instruction: ${snapshot.instruction}`,
-    `Action detail: ${snapshot.next_action.message}`,
-  ];
-  if (snapshot.next_action.command) {
-    lines.push(`Command: ${snapshot.next_action.command}`);
-  }
-  return lines;
-};
-
-export const printGovernanceNextActionHuman = (
-  snapshot: GovernanceNextActionSummary
-): void => {
-  writeInfo('[pumuki] governance next action (S1 / governance console baseline):');
-  for (const line of buildGovernanceNextActionSummaryLines(snapshot)) {
-    writeInfo(`[pumuki]   ${line}`);
-  }
-};