Skip to content

chore(docs): documentation and repository hygiene sweep for 1.6.0 - #140

Merged
tachyon-beep merged 2 commits into
release/1.6.0from
chore/docs-repo-hygiene-1.6.0
Sep 1, 2026
Merged

chore(docs): documentation and repository hygiene sweep for 1.6.0#140
tachyon-beep merged 2 commits into
release/1.6.0from
chore/docs-repo-hygiene-1.6.0

Conversation

@tachyon-beep

Copy link
Copy Markdown
Collaborator

Summary

Doc-only and repo-hygiene cleanup. No Rust or Python source changed; no CHANGELOG entry meaning changed; no federation goldens/fixtures or .sha256-pinned files touched. 114 files: 355+/240-.

By remit

Remit What changed
1. docs/ structure & staleness Repo-wide relative-link check now clean (only refs to untracked local CLAUDE.md / .filigree/ remain). ../v0.1/../1.0/ (40 ADR links + ~30 in memos/suite) with 5 anchor corrections; .loomweave/.weft/loomweave/ in current-facing docs (requirements, suite briefing/glossary, getting-started sample output); hub path ~/loom/~/weft/ (+ public mirror URL); stale install snippets v1.0.0/v1.4.0v1.5.1 with PEP 625 sdist name; v0.11.x wording in runtime-topology / language-support. Index files brought in line with their trees: docs/README.md (new non-normative section), docs/loomweave/README.md, 1.0/README.md, operator/README.md (4 missing pages), implementation/README.md, archive/README.md; new docs/federation/README.md. Archival via git mv (content verbatim + one-line archived note): 11 superseded memos → docs/archive/implementation-memos/; arch-analysis-2026-05-20-2124/docs/archive/; docs/plans/ (2 completed plans) and 6 completed rust-plugin plans (still carrying "merge into rc3/rc4" steps) → docs/superpowers/plans/archive/. Renamed sprint-3/2026-05-19-loom-……-weft-federation-hardening-tasking.md to match its title and existing inbound links.
2. ADR index Added missing ADR-055/056 rows; status cells/lines reconciled for 005/006/021/040/044/046 (ADR-046 amends 040/044 was recorded only one way); ADR-005 index title stated the pre-C1 "DB committed" policy — corrected; ADR-055 Extends: filenames, ADR-034/035 relocated paths fixed. No decision content edited.
3. Operator docs vs CLI/MCP Retired MCP aliases (summary, guidance_for, subsystem_members, issues_for, …) → current names in getting-started/clustering/guidance/secret-scanning; "eighteen tools" → 48; resolved the getting-started contradiction on whether install writes .mcp.json (it does — install.rs:253); llm_policy.enabled + allow_live_provider gate stated where summaries are introduced; llm.allow_live_provider → canonical llm_policy.*; getting-started no longer claims 1.x is not on PyPI/crates.io. All documented flags verified against --help.
4. Repo hygiene .gitignore: /.codex/, *.db-shm, /dist/, coverage.xml, editor artifacts. deploy-site.yml header comment (told the reader to retire docs.yml, which is already gone) — comment only. Deletions below.
5. www/ vs operator docs www/ is deployed by no workflow (docs.yml retired in 3d2749b; site/ Astro is live). www/README.md now says so and marks CNAME inert; version v1.1.0v1.5.1, 42+ → 48 tools, sdist name, db backup positional, doctor --format row. site/src/pages/index.astro (the live page): v1.2.1v1.5.1, ≈46 → 48 tools.

Files deleted / untracked

File Reason
.codex/config.toml git rm --cached only (kept on disk, now ignored): developer-local Codex MCP config hardcoding /home/john/... absolute paths.
.jules/bolt.md 3-line orphaned agent scratch note; referenced nowhere.
tests/perf/b8_scale_test/results/2026-05-18T0114Z/scratch.txt Contains only a stale /tmp/loomweave-b8-fix2-… path; referenced nowhere.

Deliberately left alone

  • www/ itself (unpublished but holds 4 reference pages site/ lacks) — keep-or-port is an owner decision; Pages source setting must be confirmed first.
  • Wiring scripts/check-rust-plugin-manifest-lockstep.py into verify.yml (the two plugin.toml copies are currently ungated) and adding cargo/npm ecosystems to dependabot.yml — CI behaviour changes, out of scope.
  • plugins/python/pyproject.toml description still says "v1.0 release" — ships in wheel metadata, left for a version-bump PR.
  • Historical dated memos/reviews mentioning .loomweave/, rc3/rc4, v0.1 — history, not rewritten.
  • docs/product/ staleness (current-state dated 2026-07-19) — owned by the product-checkpoint discipline.
  • Undocumented flags/subcommands (analyze --resume/--prune-unseen/--no-sei/--json, install --instructions, config, db, hook, sarif, worktree analyze) — reported, not added.
  • ADR reciprocity wording (ADR-032 "amends" ADR-006) — decision content.

Verification (local, this worktree)

cargo fmt --check, clippy -D warnings, cargo build --workspace --bins, cargo nextest (2445 passed / 3 skipped), rustdoc -D warnings, cargo deny check, ruff check/format, mypy --strict, pytest — all green.

🤖 Generated with Claude Code

Doc-only cleanup; no product behaviour changes.

- ADR index: add missing ADR-055/056 rows; reconcile status cells and
  status lines (005/006/021/040/044/046); fix ADR-005 index title that
  stated the pre-C1 policy; rewrite 40 stale ../v0.1/ links to ../1.0/;
  fix ADR-055 Extends filenames, ADR-034/035 relocated paths, and two
  detailed-design anchors.
- docs/: fix dead links/anchors repo-wide (linkcheck clean except
  untracked CLAUDE.md/.filigree refs); .loomweave/ -> .weft/loomweave/
  in current-facing docs; ~/loom/ -> ~/weft/ hub path; stale v1.0.0/
  v1.4.0 install snippets -> v1.5.1 with PEP 625 sdist name; v0.1 ->
  1.x wording in runtime-topology / language-support.
- Indexes: docs/README.md non-normative section; docs/loomweave,
  1.0, operator, implementation, archive READMEs match their trees;
  new docs/federation/README.md.
- Archival (git mv, verbatim + archived note): 11 superseded memos ->
  docs/archive/implementation-memos/; arch-analysis-2026-05-20-2124 ->
  docs/archive/; docs/plans/ + six completed rust-plugin plans ->
  docs/superpowers/plans/archive/. Rename loom- -> weft- federation
  hardening tasking memo to match its title and inbound links.
- Operator docs: retired MCP tool aliases -> current names, 48-tool
  count, install/.mcp.json contradiction resolved, llm_policy gate
  stated where summaries are introduced, llm.* -> llm_policy.* key.
- www/ + site/: version strings -> v1.5.1, tool count -> 48, sdist
  name, db backup positional, doctor --format; www/README.md now
  states www/ is not deployed (docs.yml retired in 3d2749b).
- Hygiene: untrack .codex/config.toml (machine-local paths) and ignore
  /.codex/; remove orphaned .jules/bolt.md and a stale scratch.txt;
  .gitignore gains *.db-shm, /dist/, coverage.xml, editor artifacts;
  deploy-site.yml stale header comment.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 30, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-30T18:14:41.293721Z ebacec2 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ebacec21ab

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/suite/briefing.md
2. **Findings are facts, not just errors.** A unified `Finding` record type carries defects, structural observations, classifications, metrics, and suggestions across all Weft products.
3. **Each tool is independently useful.** Loomweave works without Filigree (writes findings to local JSONL). Wardline works without Loomweave (has since day one). Filigree works without either.
4. **Local-first, single-binary, git-committable state.** No hosted service is required; `.loomweave/`, `.filigree/`, and Wardline's JSON state files are all meant to be committed and shared.
4. **Local-first, single-binary, git-committable state.** No hosted service is required; `.weft/loomweave/`, `.weft/filigree/`, and Wardline's JSON state files are all meant to be committed and shared.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Correct the git-committable state claim

Do not tell operators to commit these directories: the repository's .gitignore ignores the entire .weft/ tree, and ADR-005 explicitly says loomweave.db is no longer committed by default. Anyone following this updated path will find that git add .weft/loomweave omits the generated state, so this should describe the state as machine-local/regenerable rather than shared through Git; the same stale assertion also appears in docs/loomweave/1.0/requirements.md.

Useful? React with 👍 / 👎.

Comment thread docs/operator/getting-started.md Outdated
Comment on lines +313 to +314
Only `entity_summary_get` needs the live LLM; every other tool is
credential-free. Each is a structured graph query, not free-text grep.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document live LLM use by inferred graph queries

Qualify this claim for users invoking graph tools with confidence=inferred or all: entity_callers_list, entity_neighborhood_get, and entity_execution_path_list can dispatch the LLM and fail with LlmDisabled when no cached inference exists. Thus credentials are not exclusive to entity_summary_get, and the preceding statement that all other 47 tools work without the opt-in is also misleading for those supported inputs.

Useful? React with 👍 / 👎.

Comment thread docs/README.md
Directories that are retained for history or internal working context, not part of the release-facing reader paths:

- [archive/](./archive/README.md) — retained working notes, architecture-analysis runs, and superseded implementation memos.
- [federation/](./federation/README.md) — Loomweave's sibling-facing federation contract plus dated change-sets and responses exchanged with Filigree/Wardline.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep normative federation contracts out of the internal section

Move or qualify this entry because the new section labels every listed directory “Non-normative / internal,” while docs/federation/README.md explicitly identifies contracts.md, the migration playbook, the seam authority, and fixtures as normative contracts consumed by sibling products. The root index now gives readers the opposite authority classification for interoperability material.

Useful? React with 👍 / 👎.

Review of #140 found lines the sweep rewrote that are wrong against the
shipped behaviour:
- secret-scanning: the LLM master switch is `llm_policy.enabled: false`;
  `allow_live_provider: false` is overridden by LOOMWEAVE_LLM_LIVE=1 (the
  gate closes only when both are off, config.rs), and the outcome is
  ProviderSelection::Disabled, not the recording provider.
- getting-started: "every other tool is credential-free" widened a true
  core-tool claim to all 48; confidence=inferred graph queries, the cost
  estimator and hosted semantic search are LLM-backed.
- requirements: REQ-INTEG-WARDLINE-05's cross-reference label named
  REQ-INTEG-FILIGREE-04 while linking REQ-FINDING-04.
- two archived arch-analysis pages and the archived llm-extraction plan
  still cited their pre-move paths as live.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0183ccEmYnCh5Nx2Y6weYfHy
Copilot AI lite review requested due to automatic review settings September 1, 2026 19:31
@tachyon-beep

Copy link
Copy Markdown
Collaborator Author

Reviewed at max effort (rename-aware link/anchor check: zero broken links; no tracked file matches a new .gitignore pattern; docs.yml retirement and ADR-index reconciliation verified). Pushed one fixup commit for claims the sweep itself rewrote that are wrong against the 1.6.0 binary: the LLM master switch in secret-scanning.md (llm_policy.enabled: false, not allow_live_provider; LOOMWEAVE_LLM_LIVE=1 overrides the latter), the "every other tool is credential-free" widening in getting-started.md, the REQ-INTEG-FILIGREE-04 label on a REQ-FINDING-04 link, and three archived pages citing their pre-move paths. The v1.5.1 install pins are refreshed by the 1.6.1 bump that follows this merge. Pre-existing drifts the sweep did not touch (db backup "deferred", fictional --no-filigree flags, 42-tool design ladder, retired tool names in www/, NFR-OPS-03 git add, …) are tracked as Filigree clarion-c9321bc5d0.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

A few updated docs now contain internally inconsistent or confusing statements/links (notably NFR-OPS-03 vs ADR-005 DB commit posture), which should be corrected before merge.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Doc-only cleanup and repo-hygiene sweep aligned to the 1.6.0 documentation refresh: it updates version/tooling references, fixes/standardizes paths after doc tree reshuffles (notably .loomweave/.weft/loomweave/ and ~/loom/~/weft/), and archives superseded planning material while keeping pointer stubs and indexes coherent.

Changes:

  • Refresh public/docs-facing version + MCP tool naming references (e.g., 48-tool surface, entity_* tool names, v1.5.1 install snippets).
  • Reconcile doc-tree structure and cross-links (new/updated READMEs, archive moves, hub pointers, ADR index maintenance).
  • Repository hygiene: ignore developer-local artifacts and remove orphaned/untracked scratch files.
File summaries
File Description
www/tools.html Update tool-count wording in page metadata and lede.
www/README.md Clarify www/ is not deployed; update tool-count/version references and design-system pointer.
www/index.html Update tool-count/version and install snippet (sdist naming).
www/getting-started.html Update install snippet version + sdist naming.
www/cli.html Add doctor --format row; correct db backup positional arg docs.
tests/perf/b8_scale_test/results/2026-05-18T0114Z/scratch.txt Delete stale scratch path file.
site/src/pages/index.astro Update site landing page version + tool-count references.
README.md Update install snippet version + sdist naming.
docs/superpowers/plans/archive/2026-07-10-public-surface-tags-for-plainweave.md Add archival note header.
docs/superpowers/plans/archive/2026-06-24-loomweave-llm-extraction.md Add archival note; update internal reference path.
docs/superpowers/plans/archive/2026-06-11-rust-plugin-gold.md Add archival note header.
docs/superpowers/plans/archive/2026-06-10-rust-plugin-scale-qa.md Add archival note header.
docs/superpowers/plans/archive/2026-06-10-rust-plugin-edges.md Add archival note header.
docs/superpowers/plans/archive/2026-06-10-plugin-host-hardening.md Add archival note header.
docs/superpowers/plans/archive/2026-06-09-rust-language-plugin-phase-1b.md Add archival note header.
docs/superpowers/plans/archive/2026-06-08-rust-language-plugin-phase-1a.md Add archival note header.
docs/suite/weft.md Update federation-hub pointers to ~/weft/* + mirror URL.
docs/suite/README.md Update hub path to ~/weft; add glossary stub note.
docs/suite/glossary.md Update hub pointers and .weft/* path examples.
docs/suite/briefing.md Update hub path and .weft/* store-path examples; update v0.1 docset links to 1.0/.
docs/README.md Add “Non-normative / internal” section documenting retained internal trees.
docs/product/decisions/0010-bank-1.4.1-public-surface-tags.md Update implementation-plan link to archived location.
docs/operator/secret-scanning.md Update MCP tool names; clarify LLM policy gating (llm_policy.*).
docs/operator/runtime-topology.md Update v0.1 wording to 1.x.
docs/operator/README.md Add missing operator doc links and retired-page note.
docs/operator/language-support.md Update Python plugin status wording to 1.x.
docs/operator/guidance.md Update MCP tool names (entity_guidance_list, entity_summary_get).
docs/operator/getting-started.md Update tool names, versions, .weft/* paths, registry publishing notes, and MCP tool inventory wording.
docs/operator/clustering.md Update MCP tool name examples (subsystem_member_list, entity_summary_get).
docs/loomweave/README.md Add proposals link; clarify supporting-doc locations.
docs/loomweave/adr/README.md ADR index maintenance: clarify ADR-005/046 annotations; add ADR-055/056 rows.
docs/loomweave/adr/ADR-055-external-sqlite-federation-read-contract.md Fix Extends: links to renamed ADR filenames.
docs/loomweave/adr/ADR-050-plugin-lifecycle-deadlines.md Update implementation-plan reference to archived location.
docs/loomweave/adr/ADR-044-read-api-ephemeral-port-publication.md Annotate relocation by ADR-046 in status line.
docs/loomweave/adr/ADR-040-semantic-search-embeddings.md Annotate relocation by ADR-046 in status line.
docs/loomweave/adr/ADR-035-operational-tuning-discipline.md Update references to archived arch-analysis paths.
docs/loomweave/adr/ADR-030-on-demand-summary-scope.md Update v0.1 docset links to 1.0/ + anchor fix.
docs/loomweave/adr/ADR-028-edge-confidence-tiers.md Update detailed-design reference path to 1.0/.
docs/loomweave/adr/ADR-022-core-plugin-ontology.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-021-plugin-authority-hybrid.md Annotate amendment; update references to 1.0/.
docs/loomweave/adr/ADR-018-identity-reconciliation.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-017-severity-and-dedup.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-016-observation-transport.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-015-wardline-filigree-emission.md Update detailed-design reference to 1.0/.
docs/loomweave/adr/ADR-014-filigree-registry-backend.md Update system-design reference to 1.0/.
docs/loomweave/adr/ADR-013-pre-ingest-secret-scanner.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-012-http-auth-default.md Update system-design reference to 1.0/.
docs/loomweave/adr/ADR-011-writer-actor-concurrency.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-007-summary-cache-key.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-006-clustering-algorithm.md Update references from v0.1/ to 1.0/.
docs/loomweave/adr/ADR-005-loomweave-dir-tracking.md Update detailed-design reference path to 1.0/.
docs/loomweave/adr/ADR-004-finding-exchange-format.md Update design doc links to 1.0/.
docs/loomweave/adr/ADR-003-entity-id-scheme.md Update design doc links to 1.0/.
docs/loomweave/adr/ADR-002-plugin-transport-json-rpc.md Update design doc links to 1.0/.
docs/loomweave/adr/ADR-001-rust-for-core.md Update design doc links to 1.0/.
docs/loomweave/1.0/reviews/v1.0-publish-checklist-2026-05-24.md Fix relative links after moves.
docs/loomweave/1.0/reviews/gap-analysis-2026-05-24.md Fix relative links after moves.
docs/loomweave/1.0/requirements.md Update SARIF cross-reference; update .weft/* path in verification.
docs/loomweave/1.0/README.md Add supporting-doc links (operations + reviews).
docs/loomweave/1.0/operations.md Fix ADR-011 reference filename/path.
docs/implementation/v1.0-tag-cut/README.md Update arch-analysis link to archived location.
docs/implementation/v1.0-tag-cut/gap-register.md Update arch-analysis link to archived location.
docs/implementation/v0.1-reviews/pre-restructure/design-review.md Fix reference to current detailed-design location.
docs/implementation/v0.1-publish/ws-a-secret-scanner.md Update requirements link to 1.0/; update arch-analysis link to archive.
docs/implementation/v0.1-publish/thread-1-pre-publish-blockers.md Update arch-analysis/requirements/system-design links to new locations.
docs/implementation/v0.1-plan.md Update v0.1 design-doc links to 1.0/.
docs/implementation/sprint-3/2026-05-19-weft-federation-hardening-tasking.md Add federation-hardening tasking doc (archived planning artifact).
docs/implementation/sprint-2/b4-calls-edges.md Update design doc references to 1.0/.
docs/implementation/sprint-2/b3-contains-edges.md Update design doc references to 1.0/ + anchor alignment.
docs/implementation/sprint-2/b2-class-module-entities.md Update design doc references to 1.0/ + anchor alignment.
docs/implementation/sprint-1/wp3-python-plugin.md Update design doc references to 1.0/.
docs/implementation/sprint-1/wp2-plugin-host.md Update design doc references to 1.0/.
docs/implementation/sprint-1/wp1-scaffold.md Update design doc references to 1.0/ and config-hierarchy anchor.
docs/implementation/sprint-1/signoffs.md Update design doc references to 1.0/.
docs/implementation/README.md Update index after archive moves; add new archive pointers.
docs/implementation/qa/2026-06-10-rust-plugin-scale-qa.md Update plan link to archived location.
docs/implementation/handoffs/2026-05-18-phase3-subsystems-handoff.md Update arch-analysis + requirements links to archived/1.0/ locations.
docs/federation/README.md Add federation docs index README.
docs/federation/filigree-side/2026-05-19-registry-backend-cross-project-sequencing.md Fix Filigree ADR-014 link to local mirror path.
docs/federation/contracts.md Update hub pointers to ~/weft/*.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-release-federation-docs.md Update workspace path to archived location.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-python-plugin.md Update workspace path to archived location.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-clarion-storage.md Update workspace path to archived location.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-clarion-mcp.md Update workspace path to archived location.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-clarion-core-fixture.md Update workspace path to archived location.
docs/archive/working-notes/implementation-arch-analysis-2026-05-20-2124/task-clarion-cli-scanner.md Update workspace path to archived location.
docs/archive/README.md Expand archive index; clarify working-notes provenance.
docs/archive/implementation-memos/review-sweep-2026-05-29.md Add archival note header.
docs/archive/implementation-memos/phaseB-rename-agent-brief.md Add archival note; update master-plan pointer.
docs/archive/implementation-memos/loomweave-dogfood-remediation-2026-05-29.md Add archival note header.
docs/archive/implementation-memos/loomweave-dogfood-eval-2026-05-29.md Add archival note header.
docs/archive/implementation-memos/instructions-injection-plan.md Add archival note header.
docs/archive/implementation-memos/comprehensive-readonly-audit-2026-06-04.md Add archival note header.
docs/archive/implementation-memos/comprehensive-readonly-audit-2026-06-04-loomweave-7-agent.md Add archival note header.
docs/archive/implementation-memos/comprehensive-readonly-audit-2026-06-04-5-agent-current-main.md Add archival note header.
docs/archive/implementation-memos/agent-first-feedback-2026-06-06.md Add archival note header.
docs/archive/implementation-memos/2026-06-11-mcp-surface-audit.md Add archival note header.
docs/archive/implementation-memos/2026-06-05-loomweave-1.0-rename-and-pypi-plan.md Add archival note header.
docs/archive/arch-analysis-2026-06-02-1522/00-coordination.md Update pointer to archived RC1 analysis location.
docs/archive/arch-analysis-2026-05-20-2124/10-dependency-analysis.md Add archived RC1 dependency analysis doc.
docs/archive/arch-analysis-2026-05-20-2124/09-test-infrastructure.md Add archived RC1 test-infra summary doc.
docs/archive/arch-analysis-2026-05-20-2124/08-release-readiness.md Add archived RC1 release-readiness summary doc.
docs/archive/arch-analysis-2026-05-20-2124/07-security-surface.md Add archived RC1 security-surface summary doc.
docs/archive/arch-analysis-2026-05-20-2124/06-architect-handover.md Update archived path note for handover doc.
docs/archive/arch-analysis-2026-05-20-2124/05-quality-assessment.md Add archived RC1 quality-assessment summary doc.
docs/archive/arch-analysis-2026-05-20-2124/04-final-report.md Add archived RC1 final architecture report doc.
docs/archive/arch-analysis-2026-05-20-2124/03-diagrams.md Add archived RC1 diagrams doc.
docs/archive/arch-analysis-2026-05-20-2124/02-subsystem-catalog.md Add archived RC1 subsystem catalog doc.
docs/archive/arch-analysis-2026-05-20-2124/01-discovery-findings.md Add archived RC1 discovery findings doc.
docs/archive/arch-analysis-2026-05-20-2124/00-coordination.md Update archived path note for coordination doc.
.jules/bolt.md Delete orphaned scratch note.
.gitignore Ignore additional dev/build artifacts (/.codex/, /dist/, coverage.xml, editor artifacts).
.github/workflows/deploy-site.yml Update header comment to reflect current deploy source (Astro site/).
.codex/config.toml Remove tracked developer-local Codex config (now ignored).
Review details
  • Files reviewed: 103/114 changed files
  • Comments generated: 3
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.


**Status**: drafted 2026-05-18 — not yet broken into Filigree issues.
**Predecessor context**: Sprint 2 closed GREEN ([`../sprint-2/signoffs.md`](../sprint-2/signoffs.md)); the 2026-05-20 RC1 codebase archaeology ([`../../arch-analysis-2026-05-20-2124/04-final-report.md`](../arch-analysis-2026-05-20-2124/04-final-report.md)) supersedes the removed 2026-05-18 snapshot as the current-state reference.
**Predecessor context**: Sprint 2 closed GREEN ([`../sprint-2/signoffs.md`](../sprint-2/signoffs.md)); the 2026-05-20 RC1 codebase archaeology ([`../../../archive/arch-analysis-2026-05-20-2124/04-final-report.md`](../../archive/arch-analysis-2026-05-20-2124/04-final-report.md)) supersedes the removed 2026-05-18 snapshot as the current-state reference.
Comment on lines 958 to 962
The `.weft/loomweave/` directory (including `loomweave.db` by default) is safe to commit to git. Textual DB export (`loomweave db export --textual`) and a merge helper (`loomweave db merge-helper`) handle multi-developer conflicts.

**Rationale**: Shared analysis state benefits small teams (one developer pays the LLM cost; the team sees the briefings). Commit-by-default matches Filigree's and Wardline's storage patterns. Textual export makes git diffs meaningful.
**Verification**: `git add .loomweave && git commit` succeeds on a populated store; two developers' simultaneous runs produce a DB that the merge helper resolves deterministically.
**Verification**: `git add .weft/loomweave && git commit` succeeds on a populated store; two developers' simultaneous runs produce a DB that the merge helper resolves deterministically.
**See**: System Design §4 (Storage, File layout).
Comment on lines 70 to 73
The response includes subsystem properties and ordered member modules. Calling
`summary` on a subsystem returns `available=false` with reason
`entity_summary_get` on a subsystem returns `available=false` with reason
`summary-scope-deferred`; subsystem summarization is deferred to v0.2 and does
not call the LLM provider in v0.1.
@tachyon-beep
tachyon-beep merged commit 24bb31a into release/1.6.0 Sep 1, 2026
6 checks passed
@tachyon-beep
tachyon-beep deleted the chore/docs-repo-hygiene-1.6.0 branch September 1, 2026 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants