narcooo / inkos
Code health
This codebase scores 6.0 out of 10 for code health, which we rate fair. It also scores maintainability 8.0 and static performance 9.7 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 92 of 780 files are git hotspots, and they average 4.0 — which is where the fixes pay off most.
Do next
1 thing worth doing this quarter.
Worth planning
Delete 132 unused symbols and files (2,887 lines)
Nothing in the graph reaches them, across 32 files; every reader and agent pays to skip them.
- symbols
- 132
- lines
- 2,887
- safe to delete
- Yes(inferred)
Medium effort
Improve what Repowise can see
Add a test coverage report
Without one, Repowise cannot tell tested code from untested code, so every test-related action says “unknown”.
- line coverage
- Unknown, no report
Small effortReview the 9 proposed decisions
None is accepted yet, so nothing can drift from one and agents get no enforced guidance from them.
- proposed
- 9
- accepted
- 0
Medium effort
- Lines of code
- 151.6K
Recent activity
All commitsCommits
- a6e05d4ddocs: update Kimi K3 sponsorship copy2mo ago
- 0da86370fix(studio): stop replayed production tasks2mo ago
- efe44dfdfix(core): persist chapter state atomically2mo ago
- fc294385fix(studio): close setup and chapter workspace gaps2mo ago
- d08bbed0test(studio): account for LM Studio provider2mo ago
- 66fad52bfix(studio): widen chapter preview on large screens2mo ago
Decisions
- Replace hardcoded reasoningEffort with generic llm.extra passthroughproposed · 1mo ago
- Remove dead BookFormCard create_book toolCall path; migrate studio sidebar summary rendering to Streamdownproposed · 1mo ago
- Honor per-book review mode and add inkos auto commandproposed · 1mo ago
- Split Settler into Observer + Reflector dual-phaseproposed · 1mo ago
- Replace standalone play page with in-chat PlayHudproposed · 1mo ago
- Move book_rules frontmatter into story_frameproposed · 1mo ago
Everything we found
2,824 open
Every detector's open count by area, each with its worst example. An inventory, not a to-do list: the actions above are the part worth doing.
- worst item is critical severity. Code health1,738Untested hotspot · packages/core/src/pipeline/runner.ts65 findings · 10.0 deducted
- worst item is medium severity. Refactoring183new Command("agent") .description("Natural language agent mode (LLM orchestrates via tool-use)") .argument("<instruction>", "Natural language instruction") .option("--book <bookId>", "Bind this request to an existing book") .option("--session <sessionId>", "Reuse an agent session id") .option("--context <text>", "Additional context (natural language)") .option("--context-file <path>", "Read additional context from file") .option("--json", "Output JSON (suppress progress messages)") .option("--quiet", "Suppress non-JSON console output") .action callback+1.5 health, M effort · packages/cli/src/commands/agent.ts
- worst item is medium severity. Decisions101packages/studio/src/api/server.ts9 awaiting review · 92 hotspots ungoverned
- worst item is medium severity. Ownership668packages/studio/src/api/server.ts100% single-owner concentration, 101 commits in 90d
- worst item is low severity. Dead code134hrUnreachable function (2 lines)
Composition
Open the graphExplore this codebase
- Docs806 pages across 2 modules
- ChatAsk this codebase a question and get an answer with its sources.
- Files780 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 21 entry points
- Code healthPer-file scores, 2,019 open findings, coverage and refactoring targets
- Knowledge graphEntities, communities, and the paths between them
- Change couplingFiles that keep changing together, mined from commit history
- CommitsChange-risk ranked history with agent provenance
- ContributorsBus factor, per-file maintainers, and the human/agent split
- StatsSize class, origin, lifetime churn, rhythm and records
- CostsWhat indexing this snapshot cost, by model and by run.