chore(specs): simplify specs — remove duplication, trim stale content#1270
Merged
chore(specs): simplify specs — remove duplication, trim stale content#1270
Conversation
- Delete 008-posix-compliance.md (fully duplicated by 009, heavily outdated) - Trim 001-architecture.md: remove stale directory tree + copied API - Trim 002-parser.md: remove Token/AST definitions copied from code - Trim 003-vfs.md: remove copied Rust trait definitions, keep design decisions - Trim 004-testing.md: remove stale count tables (009 is source of truth) - Trim 005-builtins.md: remove per-flag reference (keep design: trait, ShellRef, ExecutionPlan) - Update 015-ssh-support.md: Phase 1 status → Implemented - Update AGENTS.md spec table: remove posix-compliance, add ssh-support - Fix references to deleted spec in docs/security.md, compatibility.md, 009 Net: 1,143 lines removed (7,647 → 6,504), 22 → 21 spec files.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
008-posix-compliance.md— fully duplicated by 009-implementation-status and heavily outdated (listed getopts/command/type/hash as "Future Work" when all are implemented; claimed trap was "excluded" when it's implemented)001-architecture.md(142→55 lines) — remove stale directory tree (missing git/, ssh/, scripted_tool/) and copied public API002-parser.md(178→65 lines) — remove Token enum and AST struct definitions copied from code003-vfs.md(591→163 lines) — remove copied Rust trait definitions, keep design decisions and decision tree004-testing.md(395→150 lines) — remove stale count tables that conflict with 009 (said 790 tests, 009 says 2,463)005-builtins.md(316→130 lines) — remove per-flag command reference, keep design decisions (Builtin trait, ShellRef, ExecutionPlan)015-ssh-support.md— Phase 1 status from "In Progress" to "Implemented" (1,700 lines of code exist)AGENTS.mdspec table — remove deleted spec, add 015-ssh-supportNet: 1,143 lines removed (7,647 → 6,504), 22 → 21 spec files.
Test plan
grep -r "008-posix-compliance" .returns no results