create-quiver 0.16.0 → 0.17.1

package/src/create-quiver/lib/ai/analyze-project-schema.js

@@ -0,0 +1,92 @@
+const { z } = require('zod');
+
+const ANALYZE_PROJECT_SCHEMA_VERSION = 1;
+const ANALYZE_PROJECT_KIND = 'quiver-project-analysis';
+const MAX_ANALYZE_DOC_UPDATE_LENGTH = 400_000;
+const CONFIDENCE_LEVELS = ['confirmed', 'inferred', 'unknown', 'conflict'];
+const ALLOWED_ANALYZE_DOC_UPDATE_PATHS = [
+  'docs/CONTEXTO.md',
+  'docs/AI_CONTEXT.md',
+  'docs/ARCHITECTURE.md',
+  'docs/STATUS.md',
+  'docs/DECISIONS.md',
+  'docs/PROJECT_MAP.md',
+];
+
+const confidenceSchema = z.enum(CONFIDENCE_LEVELS);
+const evidencePathSchema = z.string().trim().min(1, 'evidence path is required');
+
+const evidenceClaimSchema = z.object({
+  claim: z.string().trim().min(1, 'claim is required').max(4_000),
+  confidence: confidenceSchema,
+  evidence: z.array(evidencePathSchema).default([]),
+  notes: z.string().trim().max(2_000).default(''),
+}).strict();
+
+const namedFindingSchema = z.object({
+  name: z.string().trim().min(1, 'name is required').max(500),
+  summary: z.string().trim().max(4_000).default(''),
+  confidence: confidenceSchema.default('unknown'),
+  evidence: z.array(evidencePathSchema).default([]),
+}).strict();
+
+const productSchema = z.object({
+  name: namedFindingSchema.optional(),
+  type: namedFindingSchema.optional(),
+  summary: z.string().trim().max(4_000).default(''),
+  claims: z.array(evidenceClaimSchema).default([]),
+}).strict().default({});
+
+const domainSchema = z.object({
+  roles: z.array(namedFindingSchema).default([]),
+  entities: z.array(namedFindingSchema).default([]),
+  actions: z.array(namedFindingSchema).default([]),
+  flows: z.array(namedFindingSchema).default([]),
+  incomplete_or_suspicious: z.array(namedFindingSchema).default([]),
+  claims: z.array(evidenceClaimSchema).default([]),
+}).strict().default({});
+
+const architectureSchema = z.object({
+  frontend: z.array(namedFindingSchema).default([]),
+  backend: z.array(namedFindingSchema).default([]),
+  auth: z.array(namedFindingSchema).default([]),
+  persistence: z.array(namedFindingSchema).default([]),
+  integrations: z.array(namedFindingSchema).default([]),
+  state: z.array(namedFindingSchema).default([]),
+  api: z.array(namedFindingSchema).default([]),
+  testing: z.array(namedFindingSchema).default([]),
+  deploy: z.array(namedFindingSchema).default([]),
+  risks: z.array(namedFindingSchema).default([]),
+  claims: z.array(evidenceClaimSchema).default([]),
+}).strict().default({});
+
+const questionSchema = z.object({
+  question: z.string().trim().min(1, 'question is required').max(2_000),
+  reason: z.string().trim().max(2_000).default(''),
+  evidence: z.array(evidencePathSchema).default([]),
+}).strict();
+
+const analyzeProjectSchema = z.object({
+  schema_version: z.literal(ANALYZE_PROJECT_SCHEMA_VERSION).default(ANALYZE_PROJECT_SCHEMA_VERSION),
+  kind: z.literal(ANALYZE_PROJECT_KIND).default(ANALYZE_PROJECT_KIND),
+  product: productSchema,
+  domain: domainSchema,
+  architecture: architectureSchema,
+  features: z.array(namedFindingSchema).default([]),
+  risks: z.array(namedFindingSchema).default([]),
+  questions: z.array(questionSchema).default([]),
+  claims: z.array(evidenceClaimSchema).default([]),
+  doc_updates: z.record(z.string().trim().min(1), z.string().max(MAX_ANALYZE_DOC_UPDATE_LENGTH)).default({}),
+}).strict();
+
+module.exports = {
+  ALLOWED_ANALYZE_DOC_UPDATE_PATHS,
+  ANALYZE_PROJECT_KIND,
+  ANALYZE_PROJECT_SCHEMA_VERSION,
+  CONFIDENCE_LEVELS,
+  MAX_ANALYZE_DOC_UPDATE_LENGTH,
+  analyzeProjectSchema,
+  confidenceSchema,
+  evidenceClaimSchema,
+  namedFindingSchema,
+};

package/src/create-quiver/lib/ai/analyze-project-validation.js

@@ -0,0 +1,309 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+const {
+  ANALYZE_MANAGED_END,
+  ANALYZE_MANAGED_START,
+  normalizeAnalyzeProjectDocProposal,
+} = require('./analyze-project-docs');
+const { normalizeAnalyzeProjectAnalysis } = require('./analyze-project-parser');
+
+const VALIDATION_KIND = 'quiver-analyze-project-post-write-validation';
+
+const PLACEHOLDER_PATTERNS = [
+  { issue: 'placeholder-todo', pattern: /\bTODO\b/i },
+  { issue: 'placeholder-fixme', pattern: /\bFIXME\b/i },
+  { issue: 'placeholder-tbd', pattern: /\bTBD\b/i },
+  { issue: 'placeholder-template-token', pattern: /\{\{[^}\n]+\}\}/ },
+  { issue: 'placeholder-bracket-token', pattern: /\[(?:TODO|TBD|PLACEHOLDER|REPLACE|INSERT)[^\]\n]*\]/i },
+  { issue: 'placeholder-angle-token', pattern: /<(?:TODO|TBD|PLACEHOLDER|REPLACE|INSERT)[^>\n]*>/i },
+  { issue: 'placeholder-unfinished', pattern: /to be completed after implementation/i },
+];
+
+const FACT_KEY_ALIASES = new Map([
+  ['app', 'product'],
+  ['application', 'product'],
+  ['auth', 'auth'],
+  ['authentication', 'auth'],
+  ['backend', 'backend'],
+  ['database', 'database'],
+  ['db', 'database'],
+  ['frontend', 'frontend'],
+  ['framework', 'framework'],
+  ['package manager', 'package_manager'],
+  ['package_manager', 'package_manager'],
+  ['persistence', 'database'],
+  ['product', 'product'],
+  ['stack', 'stack'],
+]);
+
+function toPosix(filePath) {
+  return String(filePath || '').replace(/\\/g, '/');
+}
+
+function makeIssue(pathName, issue, message, extra = {}) {
+  return {
+    path: pathName || null,
+    issue,
+    message,
+    ...extra,
+  };
+}
+
+function extractManagedBlock(content) {
+  const text = String(content || '');
+  const start = text.indexOf(ANALYZE_MANAGED_START);
+  const end = text.indexOf(ANALYZE_MANAGED_END);
+  if (start < 0 || end <= start) {
+    return {
+      ok: false,
+      content: '',
+      issue: start < 0 && end < 0 ? 'managed-block-missing' : 'managed-block-unbalanced',
+    };
+  }
+  return {
+    ok: true,
+    content: text.slice(start + ANALYZE_MANAGED_START.length, end),
+    issue: '',
+  };
+}
+
+function readRelativeFile(repoRoot, relativePath) {
+  const normalized = toPosix(relativePath);
+  const absolute = path.resolve(repoRoot, normalized);
+  const repo = path.resolve(repoRoot);
+  const relative = path.relative(repo, absolute);
+  if (relative.startsWith('..') || path.isAbsolute(relative)) {
+    return {
+      ok: false,
+      path: normalized,
+      content: '',
+      issue: 'path-outside-repo',
+      message: `path is outside repository: ${normalized}`,
+    };
+  }
+  if (!fs.existsSync(absolute)) {
+    return {
+      ok: false,
+      path: normalized,
+      content: '',
+      issue: 'missing-written-doc',
+      message: `written doc is missing: ${normalized}`,
+    };
+  }
+  return {
+    ok: true,
+    path: normalized,
+    content: fs.readFileSync(absolute, 'utf8'),
+  };
+}
+
+function collectChangedDocPaths(report) {
+  const fromWritten = Array.isArray(report?.written_docs) ? report.written_docs : [];
+  const fromPlan = Array.isArray(report?.write_plan)
+    ? report.write_plan.filter((item) => item.action && item.action !== 'skip').map((item) => item.path)
+    : [];
+  return [...new Set([...fromWritten, ...fromPlan].map(toPosix).filter(Boolean))].sort();
+}
+
+function addSchemaValidation(report, errors) {
+  try {
+    normalizeAnalyzeProjectAnalysis(report.analysis, {
+      selectedFiles: report.selected_files || [],
+      promptFiles: report.prompt?.files || [],
+    });
+  } catch (error) {
+    for (const issue of error.issues || []) {
+      errors.push(makeIssue(issue.path, issue.issue || 'analysis-schema-invalid', issue.message || error.message));
+    }
+  }
+
+  try {
+    normalizeAnalyzeProjectDocProposal(report.doc_proposal);
+  } catch (error) {
+    for (const issue of error.issues || []) {
+      errors.push(makeIssue(issue.path || issue.pathName, issue.issue || 'doc-proposal-schema-invalid', issue.message || error.message));
+    }
+  }
+}
+
+function addManifestValidation(repoRoot, report, errors) {
+  if (!report?.snapshot?.manifestPath) {
+    errors.push(makeIssue('snapshot.manifestPath', 'snapshot-manifest-missing', 'snapshot manifest path is missing from write report.'));
+    return;
+  }
+
+  const manifest = readRelativeFile(repoRoot, report.snapshot.manifestPath);
+  if (!manifest.ok) {
+    errors.push(makeIssue(manifest.path, manifest.issue, manifest.message));
+    return;
+  }
+
+  try {
+    const parsed = JSON.parse(manifest.content);
+    const expectedPaths = collectChangedDocPaths(report);
+    const manifestPaths = new Set((parsed.entries || []).map((entry) => toPosix(entry.path)));
+    for (const expectedPath of expectedPaths) {
+      if (!manifestPaths.has(expectedPath)) {
+        errors.push(makeIssue(expectedPath, 'snapshot-manifest-entry-missing', `snapshot manifest does not contain an entry for ${expectedPath}.`));
+      }
+    }
+  } catch (error) {
+    errors.push(makeIssue(report.snapshot.manifestPath, 'snapshot-manifest-invalid-json', error.message));
+  }
+}
+
+function addPlaceholderValidation(docPath, managedContent, errors) {
+  for (const { issue, pattern } of PLACEHOLDER_PATTERNS) {
+    if (pattern.test(managedContent)) {
+      errors.push(makeIssue(docPath, issue, `critical placeholder remains in generated managed block: ${issue}`));
+    }
+  }
+}
+
+function normalizeFactValue(value) {
+  return String(value || '')
+    .replace(/[`*_]/g, '')
+    .replace(/\s+/g, ' ')
+    .trim()
+    .replace(/[.;,]+$/g, '')
+    .toLowerCase();
+}
+
+function isUnknownFactValue(value) {
+  const normalized = normalizeFactValue(value);
+  return !normalized
+    || normalized === 'unknown'
+    || normalized === 'none'
+    || normalized === 'n/a'
+    || normalized === 'needs confirmation'
+    || normalized === 'needs_confirmation'
+    || normalized === 'to confirm'
+    || normalized === 'not confirmed';
+}
+
+function extractFactEntries(docPath, managedContent) {
+  const facts = new Map();
+  const lines = String(managedContent || '').split(/\r?\n/);
+
+  for (const [index, rawLine] of lines.entries()) {
+    const line = rawLine
+      .replace(/^#+\s*/, '')
+      .replace(/^[-*]\s*/, '')
+      .trim();
+    const match = line.match(/^([A-Za-z _-]{2,32})\s*:\s*(.+)$/);
+    if (!match) {
+      continue;
+    }
+
+    const rawKey = match[1].trim().toLowerCase().replace(/[-\s]+/g, ' ');
+    const key = FACT_KEY_ALIASES.get(rawKey);
+    if (!key) {
+      continue;
+    }
+
+    const value = match[2].trim();
+    if (isUnknownFactValue(value)) {
+      continue;
+    }
+
+    if (!facts.has(key)) {
+      facts.set(key, []);
+    }
+    facts.get(key).push({
+      path: docPath,
+      line: index + 1,
+      value,
+      normalized: normalizeFactValue(value),
+    });
+  }
+
+  return facts;
+}
+
+function addFactConflicts(docsByPath, warnings, errors, options = {}) {
+  const projectMap = docsByPath.get('docs/PROJECT_MAP.md');
+  if (!projectMap?.managedBlock?.ok) {
+    return;
+  }
+
+  const projectFacts = extractFactEntries('docs/PROJECT_MAP.md', projectMap.managedBlock.content);
+  const contextPaths = ['docs/CONTEXTO.md', 'docs/AI_CONTEXT.md'];
+
+  for (const contextPath of contextPaths) {
+    const contextDoc = docsByPath.get(contextPath);
+    if (!contextDoc?.managedBlock?.ok) {
+      continue;
+    }
+    const contextFacts = extractFactEntries(contextPath, contextDoc.managedBlock.content);
+    for (const [key, entries] of contextFacts.entries()) {
+      const mapEntries = projectFacts.get(key) || [];
+      for (const contextEntry of entries) {
+        for (const mapEntry of mapEntries) {
+          if (contextEntry.normalized === mapEntry.normalized) {
+            continue;
+          }
+          const issue = makeIssue(contextPath, 'deterministic-doc-conflict', `${contextPath} says ${key}=${contextEntry.value}, but docs/PROJECT_MAP.md says ${key}=${mapEntry.value}.`, {
+            key,
+            project_map_value: mapEntry.value,
+            context_value: contextEntry.value,
+          });
+          if (options.strict === true) {
+            errors.push(issue);
+          } else {
+            warnings.push(issue);
+          }
+        }
+      }
+    }
+  }
+}
+
+function validateAnalyzeProjectPostWrite(repoRoot, report, options = {}) {
+  const errors = [];
+  const warnings = [];
+  const checkedDocs = [];
+  const docsByPath = new Map();
+
+  addSchemaValidation(report || {}, errors);
+  addManifestValidation(repoRoot, report || {}, errors);
+
+  for (const docPath of collectChangedDocPaths(report || {})) {
+    const file = readRelativeFile(repoRoot, docPath);
+    checkedDocs.push(docPath);
+    if (!file.ok) {
+      errors.push(makeIssue(file.path, file.issue, file.message));
+      continue;
+    }
+
+    const managedBlock = extractManagedBlock(file.content);
+    docsByPath.set(docPath, {
+      content: file.content,
+      managedBlock,
+    });
+    if (!managedBlock.ok) {
+      errors.push(makeIssue(docPath, managedBlock.issue, `Quiver managed block is missing or unbalanced in ${docPath}.`));
+      continue;
+    }
+    addPlaceholderValidation(docPath, managedBlock.content, errors);
+  }
+
+  addFactConflicts(docsByPath, warnings, errors, { strict: options.strict === true });
+
+  return {
+    schema_version: 1,
+    kind: VALIDATION_KIND,
+    strict: options.strict === true,
+    ok: errors.length === 0,
+    checked_docs: checkedDocs,
+    errors,
+    warnings,
+  };
+}
+
+module.exports = {
+  VALIDATION_KIND,
+  extractFactEntries,
+  extractManagedBlock,
+  validateAnalyzeProjectPostWrite,
+};

package/src/create-quiver/lib/ai/artifacts.js

@@ -33,7 +33,10 @@ function escapeRegExp(value) {
 }
 
 function redactSensitiveLocalValues(text, options = {}) {
-  let result = redactSecrets(text);
+  let result = redactSecrets(text)
+    .replace(/\bsk-[A-Za-z0-9_-]{16,}\b/g, '[REDACTED]')
+    .replace(/\bghp_[A-Za-z0-9_]{16,}\b/g, '[REDACTED]')
+    .replace(/\bgithub_pat_[A-Za-z0-9_]{16,}\b/g, '[REDACTED]');
   const replacements = [];
 
   if (options.projectRoot) {

package/src/create-quiver/lib/cli/command-registry.js

@@ -31,6 +31,7 @@ const SUPPORTED_COMMAND_MODES = new Set([
 const SUPPORTED_AI_COMMANDS = new Set([
   'active-slice',
   'agent',
+  'analyze-project',
   'approve',
   'approval-status',
   'approvals',

package/src/create-quiver/lib/i18n/messages/en.js

@@ -272,6 +272,7 @@ module.exports = {
     'ai.plan.with_planner_already_active': 'Planner mode: already active for ai plan; --with-planner is accepted for UX consistency.',
     'ai.planner.progress.agent_failed': 'Agent failed',
     'ai.planner.progress.agent_finished': 'Agent finished',
+    'ai.planner.progress.analyze_project': 'Analyzing project',
     'ai.planner.progress.detecting_structure': 'Detecting structure',
     'ai.planner.progress.onboarding': 'Running onboarding',
     'ai.planner.progress.plan': 'Running plan {phase}',

package/src/create-quiver/lib/i18n/messages/es.js

@@ -387,6 +387,7 @@ module.exports = {
     'ai.plan.with_planner_already_active': 'Modo planner: ya esta activo para ai plan; --with-planner se acepta por consistencia de UX.',
     'ai.planner.progress.agent_failed': 'Fallo el agente',
     'ai.planner.progress.agent_finished': 'Agente finalizado',
+    'ai.planner.progress.analyze_project': 'Analizando proyecto',
     'ai.planner.progress.detecting_structure': 'Detectando estructura',
     'ai.planner.progress.onboarding': 'Ejecutando onboarding',
     'ai.planner.progress.plan': 'Ejecutando plan {phase}',

package/.quiver/runs/run-2026-06-09t19-14-39z/approvals.json

@@ -1,5 +0,0 @@
-{
-  "schema_version": 1,
-  "run_id": "run-2026-06-09t19-14-39z",
-  "approvals": []
-}

package/.quiver/runs/run-2026-06-09t19-14-39z/decisions.md

@@ -1,2 +0,0 @@
-# Decisions
-

package/.quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/docs/INDEX.md

@@ -1,97 +0,0 @@
-# Quiver Documentation Index
-
-**Last updated:** 2026-05-29
-
-Use this file as the first documentation map before planning, implementing, reviewing, or opening PRs in this repository. Prefer the smallest set of linked documents that fits the task.
-
-## Start Here
-
-- **Public overview:** [`../README.md`](../README.md)
-- **AI guide:** [`../README_FOR_AI.md`](../README_FOR_AI.md)
-- **CLI UX standards:** [`./CLI_UX_GUIDE.md`](./CLI_UX_GUIDE.md)
-- **Command reference:** [`./reference/commands.md`](./reference/commands.md)
-- **Slice JSON schema:** [`./reference/slice-schema.md`](./reference/slice-schema.md)
-- **Troubleshooting:** [`./TROUBLESHOOTING.md`](./TROUBLESHOOTING.md)
-- **Git and PR workflow:** [`./GITFLOW_PR_GUIDE.md`](./GITFLOW_PR_GUIDE.md)
-
-## Getting Started
-
-- **Install and npx behavior:** [`./getting-started/installation.md`](./getting-started/installation.md)
-- **macOS setup:** [`./getting-started/macos.md`](./getting-started/macos.md)
-- **Linux setup:** [`./getting-started/linux.md`](./getting-started/linux.md)
-- **Windows PowerShell setup:** [`./getting-started/windows-powershell.md`](./getting-started/windows-powershell.md)
-- **Windows Git Bash / WSL setup:** [`./getting-started/windows-git-bash-wsl.md`](./getting-started/windows-git-bash-wsl.md)
-
-## Workflows
-
-- **New project:** [`./workflows/new-project.md`](./workflows/new-project.md)
-- **Existing project:** [`./workflows/existing-project.md`](./workflows/existing-project.md)
-- **Legacy Quiver project:** [`./workflows/legacy-quiver-project.md`](./workflows/legacy-quiver-project.md)
-- **Full AI spec-to-PR flow:** [`./workflows/full-ai-spec-to-pr.md`](./workflows/full-ai-spec-to-pr.md)
-
-## AI Configuration
-
-- **AI principles:** [`./ai/PRINCIPLES.md`](./ai/PRINCIPLES.md)
-- **AI rules:** [`./ai/RULES.yaml`](./ai/RULES.yaml)
-
-## Specs
-
-Canonical specs live outside `docs/` in [`../specs/`](../specs/).
-
-Recent specs:
-
-- [`../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md`](../specs/quiver-v45-ci-actions-node24-readiness/SPEC.md)
-- [`../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md`](../specs/quiver-v44-provider-live-output-tui-lite/SPEC.md)
-- [`../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md`](../specs/quiver-v43-cli-i18n-audit-release-readiness/SPEC.md)
-- [`../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md`](../specs/quiver-v42-cli-i18n-generated-docs/SPEC.md)
-- [`../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md`](../specs/quiver-v41-cli-i18n-ai-lifecycle/SPEC.md)
-- [`../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md`](../specs/quiver-v40-cli-i18n-spec-slice-workflows/SPEC.md)
-- [`../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md`](../specs/quiver-v39-cli-i18n-setup-onboarding/SPEC.md)
-- [`../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md`](../specs/quiver-v38-cli-i18n-read-only-commands/SPEC.md)
-- [`../specs/quiver-v37-cli-i18n-foundation/SPEC.md`](../specs/quiver-v37-cli-i18n-foundation/SPEC.md)
-- [`../specs/quiver-v36-ai-run-watch-portable/SPEC.md`](../specs/quiver-v36-ai-run-watch-portable/SPEC.md)
-- [`../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md`](../specs/quiver-v35-compact-dashboard-version-ux/SPEC.md)
-- [`../specs/quiver-v34-cli-dashboard-status/SPEC.md`](../specs/quiver-v34-cli-dashboard-status/SPEC.md)
-
-For implementation work, read the target spec and the target slice's `slice.json`, `EXECUTION_BRIEF.md`, and `CLOSURE_BRIEF.md` only.
-
-## Templates
-
-These files are templates for generated projects or optional profiles. Do not treat them as concrete project state unless the task is about templates or init output:
-
-- [`./AI_CONTEXT.md.template`](./AI_CONTEXT.md.template)
-- [`./AI_ONBOARDING_PROMPT.md.template`](./AI_ONBOARDING_PROMPT.md.template)
-- [`./COMMANDS.md.template`](./COMMANDS.md.template)
-- [`./CONTEXTO.md.template`](./CONTEXTO.md.template)
-- [`./DECISIONS.md.template`](./DECISIONS.md.template)
-- [`./DOCUMENTATION_GUIDE.md.template`](./DOCUMENTATION_GUIDE.md.template)
-- [`./STATUS.md.template`](./STATUS.md.template)
-- [`./SUPPORT_MATRIX.md.template`](./SUPPORT_MATRIX.md.template)
-- [`./TESTING_GUIDE_FOR_AI.md.template`](./TESTING_GUIDE_FOR_AI.md.template)
-- [`./WORKFLOW.md.template`](./WORKFLOW.md.template)
-- [`./ai/LESSONS.md.template`](./ai/LESSONS.md.template)
-
-## Task Routing
-
-- **Documentation/index work:** read this index, then the affected docs only.
-- **CLI UX, output, dashboard, or version work:** read [`./CLI_UX_GUIDE.md`](./CLI_UX_GUIDE.md), [`./reference/commands.md`](./reference/commands.md), and the relevant spec.
-- **Spec or slice execution:** read the relevant [`../specs/`](../specs/) package, especially the target slice files.
-- **PR creation:** read [`./GITFLOW_PR_GUIDE.md`](./GITFLOW_PR_GUIDE.md) and the relevant `pr.md`.
-- **Troubleshooting or install issues:** read [`./TROUBLESHOOTING.md`](./TROUBLESHOOTING.md) and the matching getting-started guide.
-- **AI agent behavior:** read [`../README_FOR_AI.md`](../README_FOR_AI.md), [`./ai/PRINCIPLES.md`](./ai/PRINCIPLES.md), and [`./ai/RULES.yaml`](./ai/RULES.yaml).
-
-## Known Documentation Debt
-
-The following concrete docs are referenced by templates or generated-project guidance but do not currently exist as repository docs:
-
-- `docs/CONTEXTO.md`
-- `docs/WORKFLOW.md`
-- `docs/STATUS.md`
-- `docs/SUPPORT_MATRIX.md`
-- `docs/TESTING_GUIDE_FOR_AI.md`
-- `docs/AI_CONTEXT.md`
-- `docs/AI_ONBOARDING_PROMPT.md`
-- `docs/DECISIONS.md`
-- `docs/ai/LESSONS.md`
-
-Use the `.template` files only when the task is about generated project output or template maintenance.

package/.quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/manifest.json

@@ -1,61 +0,0 @@
-{
-  "schema_version": 1,
-  "run_id": "run-2026-06-09t19-14-39z",
-  "created_at": "2026-06-09T19:14:39.889Z",
-  "entries": [
-    {
-      "path": "docs/INDEX.md",
-      "action": "update",
-      "existed": true,
-      "snapshot_path": ".quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/docs/INDEX.md"
-    },
-    {
-      "path": "docs/PROJECT_MAP.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/AI_CONTEXT.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/AI_ONBOARDING_PROMPT.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/CONTEXTO.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/WORKFLOW.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/ARCHITECTURE.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/STATUS.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    },
-    {
-      "path": "docs/DECISIONS.md",
-      "action": "create",
-      "existed": false,
-      "snapshot_path": null
-    }
-  ]
-}

package/.quiver/runs/run-2026-06-09t19-14-39z/state.json

@@ -1,28 +0,0 @@
-{
-  "schema_version": 1,
-  "run_id": "run-2026-06-09t19-14-39z",
-  "status": "active",
-  "phase": "onboarding-ready",
-  "spec_slug": null,
-  "created_at": "2026-06-09T19:14:39.888Z",
-  "updated_at": "2026-06-09T19:14:39.894Z",
-  "requirement": {
-    "source_file": null,
-    "path": ".quiver/runs/run-2026-06-09t19-14-39z/requirement.md"
-  },
-  "approvals_path": ".quiver/runs/run-2026-06-09t19-14-39z/approvals.json",
-  "decisions_path": ".quiver/runs/run-2026-06-09t19-14-39z/decisions.md",
-  "history": [
-    {
-      "phase": "created",
-      "command": "ai prepare-context",
-      "at": "2026-06-09T19:14:39.888Z"
-    },
-    {
-      "phase": "onboarding-ready",
-      "command": "ai prepare-context",
-      "artifact": ".quiver/runs/run-2026-06-09t19-14-39z/snapshots/20260609T191439Z/manifest.json",
-      "at": "2026-06-09T19:14:39.894Z"
-    }
-  ]
-}

package/ACTIVE_SLICES.md

@@ -1,43 +0,0 @@
-# Active Slices
-
-> Archivo local generado por `tools/scripts/refresh-active-slices.sh`.
-> No se trackea en git.
-
-**Actualizado:** 2026-06-09T19:15:40.959Z
-
-## Convencion
-
-- `Alias`: identificador corto para hablar del slice sin ambiguedad
-- `Spec`: directorio del spec
-- `slice-00`: baseline congelado, solo referencia
-- `slice-01+`: implementacion o revalidacion
-
-## Checkout Principal
-
-| Branch | Path |
-|--------|------|
-| release/create-quiver-0.16.0 | /Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/quiver |
-
-## Implementacion Activa
-
-| Alias | Spec | Slice | Branch | Estado | Path |
-|-------|------|-------|--------|--------|------|
-| QUI-01 | quiver-v52-schema-docs-release-hygiene | slice-01-json-schema-for-slice-json | feature/QUIVER-52-01-v52-slice-json-schema | completed | /Users/fabrijk/Documents/Work/Proyectos Personales/nika/frameworks/.worktrees/quiver/feature-QUIVER-52-01-v52-slice-json-schema |
-
-## Baselines Congelados
-
-| Alias | Spec | Slice | Branch | Estado | Path |
-|-------|------|-------|--------|--------|------|
-| - | - | - | - | - | - |
-
-## Worktrees Auxiliares
-
-| Branch | Path |
-|--------|------|
-| - | - |
-
-## Recomendacion Operativa
-
-- En VS Code, dejar visibles solo `develop` y la tabla de `Implementacion Activa`.
-- Tratar la tabla de `Baselines Congelados` como solo lectura.
-- Cerrar visualmente los `Worktrees Auxiliares` salvo cuando estes trabajando ese PR o esa tarea de proceso.